Skip to content

豆包 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": "明亮多彩的广告片风格,果味饼干为主角,包含草莓、苹果、葡萄、橙子四种口味,草莓味参考@图像1,饼干与对应水果以强秩序感的几何阵列排布,整体画面干净、高级、节奏强。开场水果快速建立视觉聚焦,参考@视频1的构图,音乐重拍切入。随后不同口味饼干整齐排列,切特写,参考@视频2的动态和运镜。随后迅速回到快节奏剪辑。结尾英文文字 Design by OpenHK 快速分词切换入画,配合强节奏文字运动与产品定格。"
        },
        {
            "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": "明亮多彩的广告片风格,果味饼干为主角,包含草莓、苹果、葡萄、橙子四种口味,草莓味参考@图像1,饼干与对应水果以强秩序感的几何阵列排布,整体画面干净、高级、节奏强。开场水果快速建立视觉聚焦,参考@视频1的构图,音乐重拍切入。随后不同口味饼干整齐排列,切特写,参考@视频2的动态和运镜。随后迅速回到快节奏剪辑。结尾英文文字 Design by OpenHK 快速分词切换入画,配合强节奏文字运动与产品定格。"
        },
        {
            "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提示词。取第一条非空 text
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 是 第一段参考视频——按 role 分别从 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.返回结果参数说明

FieldTypeDescription
idstringtask_id
modelstringmodel name
content.video_urlstringVideo URL 结果视频
usageobject用量信息 使用这个来计费
statusstringStatus: queued running succeeded failed
errorstring错误信息

计费

  • 根据 usage.total_tokens 计费
  • 价格会涉及是否含有参考视频resolution 模型
  • 价格单位 price:人民币/百万 token
  • 价格计算公式:usage.total_tokens*price
  • 含视频单价<不含视频,但是含视频的 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

计费规则

  • 本站计费规则:当提交任务时会先预扣 10万积分,任务完成后再按实际消耗积分多退少补
  • 比如:提交任务先预扣 10万积分,完成后实际积分是 3万积分,那么退回 7万积分