Seedream-4.0 Image Generation
- Seedream 4.0 (doubao-seedream-4.0) model supports text-to-image, image-to-image, image editing and other generation modes
- Asynchronous processing mode, use the returned task ID to query
- Generated image links are valid for 24 hours, please save them promptly
Authorizations
##All APIs require Bearer Token authentication##
Get API Key:
Visit API Key Management Page to get your API Key
Add to request header:
Body
Image generation model name
doubao-seedream-4.0 "doubao-seedream-4.0"
Prompt describing the image to be generated, or describing how to edit the input image, limited to 2000 tokens
2000"A serene lake reflecting the beautiful sunset scenery"
Specifies the upper limit for the number of images to generate, supports any integer value between [1,15]
Note:
-
If you need to generate multiple images, please include in the prompt: "
generate 2 different images" or similar instructions -
Reference image count + final generated image count ≤ 15
-
If: reference image count + required images in prompt > 15, and required images in prompt ≤ parameter n value, then final generated image count = 15 - reference image count
-
Single request will pre-charge based on the value of
n, actual billing is based on the number of images generated
1
Size of generated image, supports two formats:
Method 1 - Ratio format:
auto,1:1,2:3,3:2,3:4,4:3,4:5,5:4,9:16,16:9,21:9,9:21- Works with the
qualityparameter to automatically generate an image at the corresponding aspect ratio and resolution, without manually specifying pixels
Method 2 - Pixel format:
- Width x height, e.g.:
1280x720,1024x1024,4096x4096 - Total pixel range:
[921600, 16777216] - Aspect ratio range:
[1/16, 16]
"16:9"
Resolution tier, used with the ratio format of size.
1K, 2K, 4K "2K"
Prompt optimization strategy for setting the mode of prompt optimization function
Options:
standard: Standard mode, higher quality output, longer processing timefast: Fast mode, faster generation speed, average quality
standard, fast "standard"
Reference image URL list for image-to-image and image editing functions
Note:
- Maximum number of input images per request:
14 - Image size: not exceeding
10MB - Supported image formats:
.jpeg,.jpg,.png,.webp,.bmp,.tiff,.gif - Aspect ratio (width/height) range:
[1/16, 16] - Width/height (px) > 14
- Total pixels: not exceeding
6000×6000 - Image URLs must be directly accessible by the server, or the image URL should directly download when accessed (typically these URLs end with image file extensions, such as
.png,.jpg)
14HTTPS callback address after task completion
Callback Timing:
- Triggered when task is completed, failed, or cancelled
- Sent after billing confirmation is completed
Security Restrictions:
- Only HTTPS protocol is supported
- Callback to internal IP addresses is prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
- URL length must not exceed
2048characters
Callback Mechanism:
- Timeout:
10seconds - Maximum
3retries on failure (retries after1second/2seconds/4seconds) - Callback response body format is consistent with the task query API response format
- Callback address returning 2xx status code is considered successful, other status codes will trigger retry
"https://your-domain.com/webhooks/image-task-completed"
Response
Image generation task created successfully
Task creation timestamp
1757165031
Task ID
"task-unified-1757165031-seedream4d"
Actual model name used
"doubao-seedream-4.0"
Specific type of the task
image.generation.task Task progress percentage (0-100)
0 <= x <= 1000
Task status
pending, processing, completed, failed "pending"
Async task information
Output type of the task
text, image, audio, video "image"
Usage and billing information