Перейти к содержанию

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.