Key capabilities
- High‑quality generations with strong subject and style consistency
- Seven aspect ratios:
square_1_1,widescreen_16_9,social_story_9_16,portrait_2_3,traditional_3_4,standard_3_2,classic_4_3 - Guidance scale control (0–20, default 2.5) to tune prompt adherence vs. creative freedom
- Reproducible outputs via optional seed parameter (0–2,147,483,647)
- Async workflow with task polling and optional webhook notifications
Use cases
- Product and lifestyle imagery for e‑commerce and marketing
- Concept art and visual ideation with consistent styles
- Editorial and social assets tailored to target aspect ratios
- Brand‑aligned visuals with coherent color and composition
- Automated content pipelines integrated via webhooks
Generate images with Seedream 4
Create images by submitting a text prompt to the API. The service returns a task ID for async polling or webhook notification.POST /v1/ai/text-to-image/seedream-v4
Create a Seedream 4 generation task
GET /v1/ai/text-to-image/seedream-v4/{task-id}
Get task status and results by ID
GET /v1/ai/text-to-image/seedream-v4
List all Seedream 4 tasks
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | — | Text description of the image to generate |
aspect_ratio | string | No | square_1_1 | Output ratio: square_1_1, widescreen_16_9, social_story_9_16, portrait_2_3, traditional_3_4, standard_3_2, classic_4_3 |
guidance_scale | number | No | 2.5 | Controls prompt adherence (0–20). Higher values follow the prompt more closely |
seed | integer | No | — | Random seed for reproducible results (0–2,147,483,647) |
webhook_url | string | No | — | Callback URL for async task status notifications |
Frequently Asked Questions
What is Seedream 4 and how does it work?
What is Seedream 4 and how does it work?
Seedream 4 is a text‑to‑image generation model. You submit a text prompt via the API, receive a task ID, and poll for results or receive a webhook notification when the image is ready.
What aspect ratios are supported?
What aspect ratios are supported?
Seedream 4 supports seven aspect ratios:
square_1_1, widescreen_16_9, social_story_9_16, portrait_2_3, traditional_3_4, standard_3_2, and classic_4_3. The default is square_1_1.How does guidance_scale affect the output?
How does guidance_scale affect the output?
The
guidance_scale parameter (0–20, default 2.5) controls how closely the output follows the prompt. Higher values produce images that adhere more strictly to the text; lower values allow more creative freedom.Are outputs suitable for production?
Are outputs suitable for production?
Yes. Seedream 4 targets production‑ready image quality and prompt reliability. For extreme resolutions, pair it with an upscaler.
What is the difference between Seedream 4 and Seedream 4 Edit?
What is the difference between Seedream 4 and Seedream 4 Edit?
Seedream 4 generates images from text prompts. Seedream 4 Edit performs instruction‑driven editing on existing images, supporting addition, deletion, modification, and replacement operations with reference images.