Skip to content

Видео модель Doubao Seedance

Doubao Seedance API

1. Создание задачи

post https://api.openai-hk.com/doubao/api/v3/contents/generations/tasks

shell
curl --request POST \
  --url https://api.openai-hk.com/doubao/api/v3/contents/generations/tasks \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2-0-mini-260615",
    "content": [
        {
            "type": "text",
            "text": "Яркий и красочный рекламный стиль, главными героями являются фруктовое печенье, включая четыре вкуса: клубника, яблоко, виноград и апельсин. Клубничный вкус ссылается на @Image1. Печенье и соответствующие фрукты расположены в геометрическом массиве с сильным чувством порядка. Общая картина чистая, премиальная и ритмичная. Открытие демонстрирует фрукты, быстро устанавливающие визуальный фокус, ссылаясь на композицию @Video1, с музыкальными ударами. Затем печенье разных вкусов аккуратно расположены, переход к крупным планам, ссылаясь на динамику и движение камеры @Video2. Затем быстро возвращаемся к быстрому монтажу. Финал содержит английский текст 'One bite of crispness, a heart full of delight' с быстрым переключением по словам, сопровождаемым сильным ритмическим движением текста и стоп-кадром продукта."
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://arkdocs.tos-cn-beijing.volces.com/images/video-generation/seedance2.5_reference1.png"
            },
            "role": "reference_image"
        },
        {
            "type": "video_url",
            "video_url": {
                "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference2.mp4"
            },
            "role": "reference_video"
        },
        {
            "type": "video_url",
            "video_url": {
                "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference3.mp4"
            },
            "role": "reference_video"
        }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 15,
    "resolution": "480p",
    "omni_reference_task_type": "reference"
}
'
curl --request POST \
  --url https://api.openai-hk.com/doubao/api/v3/contents/generations/tasks \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2-0-mini-260615",
    "content": [
        {
            "type": "text",
            "text": "Яркий и красочный рекламный стиль, главными героями являются фруктовое печенье, включая четыре вкуса: клубника, яблоко, виноград и апельсин. Клубничный вкус ссылается на @Image1. Печенье и соответствующие фрукты расположены в геометрическом массиве с сильным чувством порядка. Общая картина чистая, премиальная и ритмичная. Открытие демонстрирует фрукты, быстро устанавливающие визуальный фокус, ссылаясь на композицию @Video1, с музыкальными ударами. Затем печенье разных вкусов аккуратно расположены, переход к крупным планам, ссылаясь на динамику и движение камеры @Video2. Затем быстро возвращаемся к быстрому монтажу. Финал содержит английский текст 'One bite of crispness, a heart full of delight' с быстрым переключением по словам, сопровождаемым сильным ритмическим движением текста и стоп-кадром продукта."
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://arkdocs.tos-cn-beijing.volces.com/images/video-generation/seedance2.5_reference1.png"
            },
            "role": "reference_image"
        },
        {
            "type": "video_url",
            "video_url": {
                "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference2.mp4"
            },
            "role": "reference_video"
        },
        {
            "type": "video_url",
            "video_url": {
                "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference3.mp4"
            },
            "role": "reference_video"
        }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 15,
    "resolution": "480p",
    "omni_reference_task_type": "reference"
}
'
  • Возвращает task_id
json
{
  "id": "task_6esMYNTJqw6h763PeafCp8N92fVY9Jic"
}
{
  "id": "task_6esMYNTJqw6h763PeafCp8N92fVY9Jic"
}

2. Основные параметры запроса

ПолеОбязательноОписание
modelДаИмя модели из таблицы выше
contentДаПромпт + массив справочных материалов, см. ниже
durationНетДлительность (секунды)
resolutionНетРазрешение, например 480p / 720p
ratioНетСоотношение сторон, например 16:9 (псевдоним aspect_ratio)
generate_audioНетГенерировать ли аудио

Элементы массива content:

typeПоле материалаroleОписание
texttextПромпт. Берется первый непустой текст
image_urlimage_url.urlreference_image (по умолчанию)Справочное изображение, соответствует @Image1, @Image2
image_urlimage_url.urlfirst_frame / last_frameПервый/последний кадр, не учитывается в нумерации @ImageN
video_urlvideo_url.urlreference_videoСправочное видео, соответствует @Video1, @Video2
audio_urlaudio_url.urlreference_audioСправочное аудио

Правило нумерации: порядок — это семантика. @Image1 всегда является первым справочным изображением в массиве, @Video1 — первым справочным видео—нумерация отдельно по роли, начиная с 1. Неправильный порядок не вызовет ошибку, но отрисует видео, отличающееся от вашего описания, и все равно возьмет плату.

3. Запрос задачи

get https://api.openai-hk.com/doubao/api/v3/contents/generations/tasks/{taskId}

shell
curl --request GET \
  --url https://api.openai-hk.com/doubao/api/v3/contents/generations/tasks/task_6esMYNTJqw6h763PeafCp8N92fVY9Jic \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json'
curl --request GET \
  --url https://api.openai-hk.com/doubao/api/v3/contents/generations/tasks/task_6esMYNTJqw6h763PeafCp8N92fVY9Jic \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json'
  • Успешный ответ
json
{
  "content": {
    "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0-mini/02178996062422000000000000000000000ffffac1446bb35c08d.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20260921%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20260921T031836Z&X-Tos-Expires=86400&X-Tos-Signature=601f68beb9da380599efea3817ce91612be94beabb085848281fa1ba9047b66c&X-Tos-SignedHeaders=host"
  },
  "created_at": 1789960624,
  "draft": false,
  "duration": 4,
  "execution_expires_after": 172800,
  "framespersecond": 24,
  "generate_audio": true,
  "id": "task_6esMYNTJqw6h763PeafCp8N92fVY9Jic",
  "model": "doubao-seedance-2-0-mini-260615-max",
  "origin_id": "cgt-20260921111703-hsk6d",
  "output_format": "mp4",
  "priority": 0,
  "ratio": "16:9",
  "resolution": "480p",
  "seed": 47550,
  "service_tier": "default",
  "status": "succeeded",
  "updated_at": 1789960725,
  "usage": {
    "completion_tokens": 40594,
    "total_tokens": 40594
  }
}
{
  "content": {
    "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0-mini/02178996062422000000000000000000000ffffac1446bb35c08d.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20260921%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20260921T031836Z&X-Tos-Expires=86400&X-Tos-Signature=601f68beb9da380599efea3817ce91612be94beabb085848281fa1ba9047b66c&X-Tos-SignedHeaders=host"
  },
  "created_at": 1789960624,
  "draft": false,
  "duration": 4,
  "execution_expires_after": 172800,
  "framespersecond": 24,
  "generate_audio": true,
  "id": "task_6esMYNTJqw6h763PeafCp8N92fVY9Jic",
  "model": "doubao-seedance-2-0-mini-260615-max",
  "origin_id": "cgt-20260921111703-hsk6d",
  "output_format": "mp4",
  "priority": 0,
  "ratio": "16:9",
  "resolution": "480p",
  "seed": 47550,
  "service_tier": "default",
  "status": "succeeded",
  "updated_at": 1789960725,
  "usage": {
    "completion_tokens": 40594,
    "total_tokens": 40594
  }
}
  • Ответ с ошибкой
json
{
  "error": {
    "code": "invalid_request",
    "message": "Upstream submit failed (400): {\"code\":\"fail_to_fetch_task\",\"message\":\"{\\\"error\\\":{\\\"code\\\":\\\"InvalidParameter\\\",\\\"message\\\":\\\"The parameter `output_format` specified in the request is not valid: the specified model does not support this output_format"
  },
  "id": "task_6CyBKW7HUIRQGEB45CQ8r1a0gQwugHDF",
  "model": "doubao-seedance-2-0-mini-260615-max",
  "status": "failed"
}
{
  "error": {
    "code": "invalid_request",
    "message": "Upstream submit failed (400): {\"code\":\"fail_to_fetch_task\",\"message\":\"{\\\"error\\\":{\\\"code\\\":\\\"InvalidParameter\\\",\\\"message\\\":\\\"The parameter `output_format` specified in the request is not valid: the specified model does not support this output_format"
  },
  "id": "task_6CyBKW7HUIRQGEB45CQ8r1a0gQwugHDF",
  "model": "doubao-seedance-2-0-mini-260615-max",
  "status": "failed"
}

4. Параметры ответа

ПолеТипОписание
idstringtask_id
modelstringИмя модели
content.video_urlstringURL результата видео
usageobjectИнформация об использовании для выставления счета
statusstringСтатус: queued running succeeded failed
errorstringСообщение об ошибке

Биллинг

  • Счет выставляется на основе usage.total_tokens
  • Цена зависит от наличия справочного видео, разрешения, модели
  • Единица цены: CNY за миллион токенов
  • Формула расчета цены: usage.total_tokens × цена
  • С видео цена за единицу < без видео, но с видео usage.total_tokens выше, поэтому общая цена с видео выше
МодельС видеоБез видео
doubao-seedance-2-0-mini-260615 все разрешения1423
doubao-seedance-2-0-fast-260128 все разрешения2237
doubao-seedance-2-0-260128 480P/720P2846
doubao-seedance-2-0-260128 1080P3151
doubao-seedance-2-0-260128 4K1626
doubao-seedance-2-5-260628 480P/720P4270
doubao-seedance-2-5-260628 1080P4677