doubao-seedream-5-0-pro API Руководство по модели
Краткий вывод
- 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.
Ключевые возможности
- 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 generating marketing, e-commerce, and social visual assets quickly.
- When reference-guided consistency is required.
Когда не использовать
- For long-form video generation workflows.
- For complex multi-turn reasoning conversations.
Особенности работы
- Uses unified image generation endpoints with task-style responses.
- Poll task status and fetch result URLs after completion.
Минимальный запрос
{
"model": "doubao-seedream-5-0-pro",
"prompt": "Premium product poster, soft light, realistic texture, minimal background",
"size": "1:1"
}
Минимальный ответ
{
"id": "task_img_xxxxxxxx",
"object": "generation.task",
"model": "doubao-seedream-5-0-pro",
"status": "queued",
"progress": 0
}
Ключевые параметры
| Параметр | Тип | Обяз. | По умолчанию | Диапазон | Описание |
|---|
| model | string | Да | doubao-seedream-5-0-pro | - | Exact model identifier from ToAPIs. |
| prompt | string | Да | - | - | Primary image instruction prompt. |
| size | string | Нет | 1:1 | - | Output aspect ratio, model-dependent. |
| n | integer | Нет | 1 | - | Number of generated images per request. |
| reference_images | file[] | Нет | - | - | Reference images for style consistency. |
Частые ошибки
| HTTP | Code | Триггер | Исправление | Повтор |
|---|
| 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.
- Ошибка у модели изображений или видео: invalid apitype: -1
Обычно это означает, что запрос отправлен не в тот endpoint. Модели изображений и видео обычно не используют chat endpoint. Вместо этого нужно отправлять HTTP-запрос на создание задачи по документации и затем опрашивать endpoint статуса задачи. Сначала проверьте фактический код запроса, URL и payload.
- Задача на генерацию изображения или видео завершилась ошибкой, но списание произошло
Сначала попросите у пользователя лог задачи или скриншот и проверьте, есть ли там статистика входных или выходных токенов. Если учет токенов есть, запрос, скорее всего, был отправлен через chat endpoint, а не через правильный media workflow. Модели изображений и видео обычно работают как асинхронные HTTP task API: сначала отправляется задача, затем выполняется опрос по task id согласно документации.
Связанные API
