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

Seedance

Seedance — семейство моделей для генерации видео через 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: seedance-1-5-pro

Для seedance-1-5-pro в теле запроса указывайте model: doubao-seedance-1-5-pro-251215.

Асинхронная обработка

Seedance возвращает id задачи, а не готовое видео. После создания задачи опрашивайте GET /seedance/contents/generations/tasks/{id} до статуса succeeded, затем заберите URL из content.video_url.

Создание video-задачи

POST /seedance/contents/generations/tasks

Метод создаёт задачу генерации видео. seedance-1-5-pro поддерживает text-to-video, image-to-video по первому кадру, first/last frames, draft mode и генерацию аудио.

Параметры запроса

Поле Тип Обязательное По умолчанию Описание
model string Да — ID backend-модели. Для seedance-1-5-pro используйте doubao-seedance-1-5-pro-251215.
content array<object> Да — Список входного контента: текст, изображения или draft task.
content[].type string Да — Тип элемента: text, image_url, draft_task.
content[].text string Для type: text — Текстовый промпт. Поддерживает китайский и английский; рекомендуется не превышать 500 слов. Параметры можно добавлять в конец промпта через --parameter.
content[].image_url object Для type: image_url — Объект изображения.
content[].image_url.url string Для type: image_url — URL изображения или Base64 Data URL вида data:image/<format>;base64,<data>. Формат в префиксе должен быть в нижнем регистре.
content[].role string Для first/last frames — Роль изображения: first_frame, last_frame. Для одного первого кадра можно не указывать или указать first_frame.
content[].draft_task object Для type: draft_task — Объект draft task ID для генерации финального видео на основе черновика.
content[].draft_task.id string Для type: draft_task — ID успешно созданной draft-задачи.
callback_url string Нет — URL для callback-уведомлений при изменении статуса задачи.
return_last_frame boolean Нет false Вернуть последний кадр сгенерированного видео. Для draft mode не поддерживается.
service_tier string Нет default Уровень сервиса: default. Значение flex описано в upstream API, но сейчас недоступно.
execution_expires_after integer Нет 172800 Время жизни выполнения в секундах. Диапазон: 3600–259200.
generate_audio boolean Нет true Генерировать синхронизированное аудио: речь, эффекты и музыку. Для лучшего результата реплики помещайте в двойные кавычки.
draft boolean Нет false Включает draft mode для быстрого preview. Поддерживает только 480p, не поддерживает return_last_frame и offline/flex режим.

Параметры в prompt

Часть настроек можно передавать прямо в тексте промпта, например --ratio 16:9, --dur 5, --rs 720p, --seed 12345, --wm true. Для seedance-1-5-pro параметр frames не поддерживается.

Text-to-video

curl https://api.cdnvideo.ru/app/aihub-router/v1/media/seedance/contents/generations/tasks \
  -H "Authorization: Bearer ${AIHUB_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "X-Model: seedance-1-5-pro" \
  -d '{
    "model": "doubao-seedance-1-5-pro-251215",
    "content": [
      {
        "type": "text",
        "text": "Multiple shots. A detective enters a dimly lit room. He checks the clues on the table and picks up an item. The camera pans to him thinking. --ratio 16:9"
      }
    ],
    "generate_audio": true
  }'

Ответ

{
  "id": "cgt-2025******-****"
}

Image-to-video: первый кадр

Для генерации по первому кадру передайте один элемент image_url. Роль можно не указывать или задать first_frame.

curl https://api.cdnvideo.ru/app/aihub-router/v1/media/seedance/contents/generations/tasks \
  -H "Authorization: Bearer ${AIHUB_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "X-Model: seedance-1-5-pro" \
  -d '{
    "model": "doubao-seedance-1-5-pro-251215",
    "content": [
      {
        "type": "text",
        "text": "A girl is holding a fox. The girl opens her eyes, looks gently at the camera, and the fox cuddles up friendly. The camera slowly pulls back. --ratio adaptive --dur 5"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/first-frame.png"
        },
        "role": "first_frame"
      }
    ]
  }'

First and last frames

Для генерации перехода между первым и последним кадром передайте два изображения с ролями first_frame и last_frame.

curl https://api.cdnvideo.ru/app/aihub-router/v1/media/seedance/contents/generations/tasks \
  -H "Authorization: Bearer ${AIHUB_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "X-Model: seedance-1-5-pro" \
  -d '{
    "model": "doubao-seedance-1-5-pro-251215",
    "content": [
      {
        "type": "text",
        "text": "A blue-green mythical bird transforms into a human form --rs 720p --dur 5 --cf false"
      },
      {
        "type": "image_url",
        "image_url": {"url": "https://example.com/first-frame.png"},
        "role": "first_frame"
      },
      {
        "type": "image_url",
        "image_url": {"url": "https://example.com/last-frame.png"},
        "role": "last_frame"
      }
    ],
    "return_last_frame": true
  }'

Draft mode

Draft mode позволяет быстро проверить структуру сцены, монтаж, действия объектов и соответствие промпту. Черновик дешевле обычного видео, но поддерживает только 480p, не поддерживает return_last_frame и flex.

Шаг 1. Создать draft

curl https://api.cdnvideo.ru/app/aihub-router/v1/media/seedance/contents/generations/tasks \
  -H "Authorization: Bearer ${AIHUB_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "X-Model: seedance-1-5-pro" \
  -d '{
    "model": "doubao-seedance-1-5-pro-251215",
    "content": [
      {
        "type": "text",
        "text": "A girl is holding a fox. The girl opens her eyes, looks gently at the camera, and the fox cuddles up friendly."
      },
      {
        "type": "image_url",
        "image_url": {"url": "https://example.com/first-frame.png"}
      }
    ],
    "seed": 20,
    "duration": 6,
    "draft": true
  }'

Шаг 2. Создать финальное видео по draft

После успешной генерации draft передайте его ID как draft_task.

curl https://api.cdnvideo.ru/app/aihub-router/v1/media/seedance/contents/generations/tasks \
  -H "Authorization: Bearer ${AIHUB_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "X-Model: seedance-1-5-pro" \
  -d '{
    "model": "doubao-seedance-1-5-pro-251215",
    "content": [
      {
        "type": "draft_task",
        "draft_task": {"id": "cgt-2026******-AAAAA"}
      }
    ],
    "watermark": false,
    "resolution": "720p",
    "return_last_frame": true,
    "service_tier": "default"
  }'

Получение статуса задачи

GET /seedance/contents/generations/tasks/{id}

Метод возвращает статус задачи и URL готового видео при успешном завершении.

Path-параметры

Параметр Тип Обязательное Описание
id string Да ID задачи из ответа создания, например cgt-2025******-****.

Пример curl

curl https://api.cdnvideo.ru/app/aihub-router/v1/media/seedance/contents/generations/tasks/cgt-2025******-**** \
  -H "Authorization: Bearer ${AIHUB_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "X-Model: seedance-1-5-pro"

Ответ завершённой задачи

{
  "id": "cgt-2025******-****",
  "model": "doubao-seedance-1-5-pro-251215",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/generated-video.mp4"
  },
  "seed": 10,
  "resolution": "720p",
  "duration": 5,
  "ratio": "16:9",
  "framespersecond": 24,
  "usage": {
    "completion_tokens": 108900,
    "total_tokens": 108900
  },
  "created_at": 1743414619,
  "updated_at": 1743414673
}

Статусы задачи

Статус Описание
queued Задача поставлена в очередь.
running Задача выполняется.
succeeded Задача успешно завершена.
failed Задача завершилась ошибкой.
cancelled Задача отменена или удалена.

Список задач

GET /seedance/contents/generations/tasks?page_num={page_num}&page_size={page_size}&filter.status={status}&filter.task_ids={task_ids}&filter.model={model}

Метод возвращает список задач с фильтрами по статусу, ID и модели.

Пример curl

curl "https://api.cdnvideo.ru/app/aihub-router/v1/media/seedance/contents/generations/tasks?page_size=3&filter.status=succeeded" \
  -H "Authorization: Bearer ${AIHUB_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "X-Model: seedance-1-5-pro"

Отмена или удаление задачи

DELETE /seedance/contents/generations/tasks/{id}

Метод отменяет или удаляет video-задачу.

Пример curl

curl -X DELETE https://api.cdnvideo.ru/app/aihub-router/v1/media/seedance/contents/generations/tasks/cgt-2025******-**** \
  -H "Authorization: Bearer ${AIHUB_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "X-Model: seedance-1-5-pro"

Типовой сценарий

  1. Создайте задачу через POST /seedance/contents/generations/tasks.
  2. Сохраните id из ответа.
  3. Опрашивайте GET /seedance/contents/generations/tasks/{id} до статуса succeeded.
  4. Скачайте видео по content.video_url.

Ограничения

  • Для seedance-1-5-pro указывайте X-Model: seedance-1-5-pro и model: doubao-seedance-1-5-pro-251215.
  • Рекомендуемая длина prompt — до 500 слов.
  • seedance-1-5-pro не поддерживает параметр frames.
  • generate_audio поддерживается в seedance-1-5-pro; по умолчанию включён.
  • Draft mode поддерживает только 480p и не поддерживает return_last_frame.
  • service_tier: flex описан в upstream API, но сейчас недоступен.