Seedream
Seedream — семейство моделей для генерации и редактирования изображений через CDNvideo AI Hub media API.
Base URL
https://api.cdnvideo.ru/app/aihub-router/v1/media
Для работы используется обычный ключ AI Hub в заголовке Authorization. Модель для маршрутизации передаётся в X-Model:
Authorization: Bearer ${AIHUB_API_KEY}
X-Model: seedream-4.5
Сейчас для этой вкладки используется модель seedream-4.5.
Генерация изображений
POST /seedream/image/generations
Метод генерирует изображения по текстовому описанию и поддерживает image-to-image сценарии с одним или несколькими референсами.
Параметры запроса
| Поле | Тип | Обязательное | По умолчанию | Описание |
|---|---|---|---|---|
prompt |
string |
Да | — | Промпт для генерации. Поддерживает русский, английский, китайский и другие языки. Рекомендуется не превышать 600 английских слов или 300 русских символов. |
image |
string или array<string> |
Нет | — | Входное изображение или список изображений для image-to-image. Поддерживаются публичные URL и Base64 Data URL вида data:image/<format>;base64,<data>. seedream-4.5 поддерживает до 14 референс-изображений. |
size |
string |
Нет | 2048x2048 |
Размер результата. Можно указать класс разрешения 2K или 4K, либо точный размер в пикселях, например 2560x1440. Эти способы нельзя смешивать в одном значении. |
sequential_image_generation |
string |
Нет | disabled |
Управляет group image режимом: auto — модель сама решает, возвращать ли серию изображений; disabled — сгенерировать одно изображение. |
sequential_image_generation_options |
object |
Нет | — | Настройки group image режима. Работают только при sequential_image_generation: auto. |
sequential_image_generation_options.max_images |
integer |
Нет | 15 |
Максимальное количество изображений в запросе. Диапазон: 1–15. Количество входных референсов + количество выходных изображений должно быть не больше 15. |
stream |
boolean |
Нет | false |
Включает streaming-режим. При true изображения возвращаются по мере готовности. |
response_format |
string |
Нет | url |
Формат результата: url или b64_json. URL результата действует 24 часа. |
watermark |
boolean |
Нет | true |
Добавлять водяной знак AI Generated в правом нижнем углу. |
optimize_prompt_options |
object |
Нет | — | Настройки оптимизации промпта. |
optimize_prompt_options.mode |
string |
Нет | standard |
Режим оптимизации промпта: standard. Для seedream-4.5 режим fast не поддерживается. |
Параметры других версий
В исходном API также встречаются параметры seed, guidance_scale, tools и output_format, но для seedream-4.5 они не используются или относятся к другим версиям семейства Seedream.
Требования к image
| Требование | Описание |
|---|---|
| Форматы | jpeg, png, webp, bmp, tiff, gif. |
| Передача URL | URL должен быть публично доступен. |
| Передача Base64 | Используйте Data URL с префиксом, например data:image/png;base64,<base64_image>. Формат изображения в префиксе указывается в нижнем регистре. |
| Соотношение сторон | От 1/16 до 16. |
| Размеры | Ширина, высота и длина изображения должны быть больше 14px. |
| Размер файла | До 10MB. |
| Общее количество пикселей | До 6000x6000, то есть до 36 000 000 пикселей на одно изображение. |
| Количество референсов | До 14 входных изображений. |
Размеры результата
Для seedream-4.5 можно указать size двумя способами.
| Способ | Значения | Описание |
|---|---|---|
| Класс разрешения | 2K, 4K |
Укажите класс разрешения, а соотношение сторон, форму или назначение опишите в prompt. Итоговый размер определит модель. |
| Точный размер | Например 2048x2048, 2560x1440 |
Укажите ширину и высоту в пикселях. Нужно одновременно соблюдать диапазон общего количества пикселей и соотношение сторон. |
Для точного размера seedream-4.5 поддерживает общий диапазон пикселей от 2560x1440 до 4096x4096, а соотношение сторон — от 1/16 до 16.
Рекомендуемые размеры для seedream-4.5
| Соотношение сторон | Размер |
|---|---|
1:1 |
2048x2048 |
4:3 |
2304x1728 |
3:4 |
1728x2304 |
16:9 |
2560x1440 |
9:16 |
1440x2560 |
3:2 |
2496x1664 |
2:3 |
1664x2496 |
21:9 |
3024x1296 |
Text-to-image
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/seedream/image/generations \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-H "X-Model: seedream-4.5" \
-d '{
"prompt": "A vibrant close-up editorial portrait of a model with a piercing gaze, wearing a sculptural hat, rich color blocking, sharp focus on the eyes, shallow depth of field, Vogue magazine cover aesthetic, medium format, dramatic studio lighting.",
"size": "2K",
"watermark": false
}'
Image-to-image
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/seedream/image/generations \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-H "X-Model: seedream-4.5" \
-d '{
"prompt": "Keep the model pose and flowing garment shape. Change the garment material to transparent clear water, with refractive lighting and prismatic caustic highlights.",
"image": "https://example.com/reference.png",
"size": "2K",
"watermark": false
}'
Multi-image generation
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/seedream/image/generations \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-H "X-Model: seedream-4.5" \
-d '{
"prompt": "Replace the clothing in Image 1 with the clothing in Image 2.",
"image": [
"https://example.com/source-model.png",
"https://example.com/source-clothing.png"
],
"sequential_image_generation": "disabled",
"size": "2K",
"watermark": false
}'
Group image generation
Для генерации серии изображений включите sequential_image_generation: auto. Максимальное количество изображений задаётся через sequential_image_generation_options.max_images.
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/seedream/image/generations \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-H "X-Model: seedream-4.5" \
-d '{
"prompt": "Create a consistent 3-frame editorial fashion story with the same character and changing poses.",
"size": "2K",
"sequential_image_generation": "auto",
"sequential_image_generation_options": {
"max_images": 3
},
"watermark": false
}'
Формат ответа
Non-streaming ответ
{
"model": "doubao-seedream-4-5-251128",
"created": 1757323224,
"data": [
{
"url": "https://example.com/generated-image.jpg",
"size": "1760x2368"
}
],
"usage": {
"generated_images": 1,
"output_tokens": 16280,
"total_tokens": 16280
}
}
В некоторых ответах может возвращаться обёртка с code, message, data, request_id и дополнительными полями parameters, usage, created_at.
{
"code": 0,
"message": "success",
"data": {
"images": [
{
"url": "https://example.com/generated-image.jpg",
"width": 2560,
"height": 1440,
"size": "2K",
"format": "jpg"
}
],
"usage": {
"total_tokens": 85,
"image_count": 1
},
"request_id": "req_abc123def456"
}
}
Streaming ответ
event: image_generation.partial_succeeded
data: {
"type": "image_generation.partial_succeeded",
"model": "doubao-seedream-4-5-251128",
"created": 1757396757,
"image_index": 0,
"url": "https://example.com/image-1.jpg",
"size": "2496x1664"
}
event: image_generation.completed
data: {
"type": "image_generation.completed",
"model": "doubao-seedream-4-5-251128",
"created": 1757396825,
"usage": {
"generated_images": 3,
"output_tokens": 48672,
"total_tokens": 48672
}
}
data: [DONE]
События streaming-режима
| Событие | Описание |
|---|---|
image_generation.partial_succeeded |
Возвращается, когда отдельное изображение успешно сгенерировано. |
image_generation.partial_failed |
Возвращается, когда отдельное изображение не удалось сгенерировать. Если причина — модерация, остальные изображения продолжают генерироваться. При внутренней ошибке 500 генерация следующих изображений может быть остановлена. |
image_generation.completed |
Финальное событие после обработки всех изображений. |
Ошибки
{
"error": {
"code": "BadRequest",
"message": "The request failed because it is missing one or multiple required parameters. Request ID: req_abc123"
}
}
Ограничения
- Для
seedream-4.5указывайтеX-Model: seedream-4.5. promptрекомендуется держать в пределах600английских слов или300китайских символов.seedream-4.5поддерживает до14входных референс-изображений.- При group image режиме количество входных референсов + количество выходных изображений должно быть не больше
15. - URL результата при
response_format: urlдействует24часа. sizeможно задавать как2Kили4K, либо как точный размер, например2560x1440.- Для
seedream-4.5не используйтеseed,guidance_scale,tools,output_formatиoptimize_prompt_options.mode: fast.