doubao-seedream-5-0-pro API Model Guide
TL;DR
- Supports prompt-based text-to-image workflows for marketing and creative assets.
- Supports reference-guided generation for stronger style consistency.
- Stabilize parameters in this guide first, then move into production API.
Core Capabilities
- High-quality generation：Generate production-ready visual assets via a unified API.
- Reference consistency：Use references to stabilize style and composition.
- Parameter tuning：Tune ratio/count/sampling for quality and cost balance.
When to Use
- When generating marketing, e-commerce, and social visual assets quickly.
- When reference-guided consistency is required.
When Not to Use
- For long-form video generation workflows.
- For complex multi-turn reasoning conversations.
Runtime Behavior
- Uses unified image generation endpoints with task-style responses.
- Poll task status and fetch result URLs after completion.
Minimal Request
{
"model": "doubao-seedream-5-0-pro",
"prompt": "Premium product poster, soft light, realistic texture, minimal background",
"size": "1:1"
}
Minimal Response
{
"id": "task_img_xxxxxxxx",
"object": "generation.task",
"model": "doubao-seedream-5-0-pro",
"status": "queued",
"progress": 0
}
Key Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|
| model | string | Yes | doubao-seedream-5-0-pro | - | Exact model identifier from ToAPIs. |
| prompt | string | Yes | - | - | Primary image instruction prompt. |
| size | string | No | 1:1 | - | Output aspect ratio, model-dependent. |
| n | integer | No | 1 | - | Number of generated images per request. |
| reference_images | file[] | No | - | - | Reference images for style consistency. |
Common Errors
| HTTP | Code | Trigger | Fix Action | Retry Policy |
|---|
| 400 | invalid_request_error | Missing or invalid payload fields. | Validate model/prompt/size payload fields. | Retry only after payload fix. |
| 401 | authentication_error | Missing or invalid API key. | Verify Authorization header and key scope. | Retry after authentication fix. |
FAQ
- What is doubao-seedream-5-0-pro best for?
Best for high-frequency creative generation and reference-guided consistency workflows.
- Image or video model error: invalid apitype: -1
This usually means the request was sent to the wrong endpoint. Image and video models typically do not use the chat endpoint. Instead, submit the documented HTTP task request and poll the task status endpoint for results. Check the actual request code, URL, and payload first.
- An image or video task failed, but the user was still charged
Ask the user for the task log or screenshot first and check whether input or output token usage appears. If token accounting shows up, the request was likely sent through a chat endpoint instead of the proper media workflow. Image and video models usually run as async HTTP task APIs: submit the task first, then poll by task id according to the relevant docs.
Related APIs
