文档版本:v1.0.0 | 最后更新:2026-06-11 本平台已完整适配豆包 Seedance 系列官方视频生成接口,请求与响应均为透传,参数语义与官方一致。
POST /seedance/api/v3/contents/generations/tasks 提交,由 model 与 content 数组中的内容类型区分场景:| 任务类型 | 关键入参 | 支持模型 |
|---|---|---|
| 文生视频(T2V) | content 中仅含 text | 全系列 |
| 图生视频-首帧(I2V) | content 中含 image_url(role=first_frame) | 全系列 |
| 图生视频-首尾帧(FL2V) | content 中含 image_url(role=first_frame + role=last_frame) | 2.0 系列、1.5 pro、1.0 pro |
| 多模态参考(Multimodal Reference) | content 中含参考图片/视频/音频 | 仅 2.0 系列 |
| 有声视频 | generate_audio=true | 2.0 系列、1.5 pro |
| 样片模式(Draft) | draft=true | 仅 1.5 pro |
id(任务 ID),需通过查询接口轮询任务状态;任务成功后响应中直接包含 content.video_url(视频下载地址),无需单独调用下载接口。创建任务 (POST /seedance/api/v3/contents/generations/tasks)
│ 返回 id(任务 ID,7 天有效)
▼
查询状态 (GET /seedance/api/v3/contents/generations/tasks/{id}) ← 轮询直至 succeeded 或 failed
│ 返回 content.video_url(24 小时有效)
▼
下载 MP4 视 频文件| 接口 | 方法 | 地址 |
|---|---|---|
| 创建视频生成任务 | POST | https://platform.dataeyes.ai/seedance/api/v3/contents/generations/tasks |
| 查询视频生成任务 | GET | https://platform.dataeyes.ai/seedance/api/v3/contents/generations/tasks/{id} |
| 查询视频生成任务列表 | GET | https://platform.dataeyes.ai/seedance/api/v3/contents/generations/tasks?page_num=...&page_size=... |
| 取消或删除视频生成任务 | DELETE | https://platform.dataeyes.ai/seedance/api/v3/contents/generations/tasks/{id} |
路径规则:在平台域名后追加渠道前缀 /seedance,再拼接豆包 Seedance 官方原始路径即可。
例如官方https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks→ 平台https://platform.dataeyes.ai/seedance/api/v3/contents/generations/tasks。
Authorization 头携带 Bearer 密钥进行鉴权:Authorization: Bearer {API_KEY}{API_KEY} 为您在 DataEyes 控制台创建的接口密钥。| 头部 | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer {API_KEY} |
Content-Type | 是 | 固定为 application/json(创建任务接口) |
| 功能 | 说明 | 适用模型 |
|---|---|---|
有声视频(generate_audio) | 生成视频同时自动配音,默认开启 | 2.0 系列、1.5 pro |
样片模式(draft) | 快速生成低成本样片,确认效果后再正式生成 | 仅 1.5 pro |
自适应比例(ratio=adaptive) | 根据输入图片自动推断最佳画面比例 | 2.0 系列、1.5 pro |
工具调用(tools) | 支持 web_search 等工具增强生成效果 | 仅 2.0 系列 |
优先级(priority) | 指定任务优先级 [0, 9],数值越大优先级越高 | 仅 2.0 系列 |
回调通知(callback_url) | 任务状态变更时主动推送回调 | 全系列 |
| 模型 | T2V | I2V 首帧 | I2V 首尾帧 | 多模态参考 | 有声视频 | 样片模式 | 默认分辨率 | 时长范围 |
|---|---|---|---|---|---|---|---|---|
doubao-seedance-2-0-v2-250528 | ✅ | ✅ | ✅ | ✅ | ✅ | — | 720p | 4–15s 或 -1 |
doubao-seedance-2-0-fast-250528 | ✅ | ✅ | ✅ | ✅ | ✅ | — | 720p | 4–15s 或 -1 |
doubao-seedance-1-5-pro-251215 | ✅ | ✅ | ✅ | — | ✅ | ✅ | 720p | 4–12s 或 -1 |
doubao-seedance-1-0-pro-250401 | ✅ | ✅ | ✅ | — | — | — | 1080p | 2–12s |
doubao-seedance-1-0-pro-fast-250401 | ✅ | ✅ | — | — | — | — | 1080p | 2–12s |
| 状态 | 含义 |
|---|---|
queued | 排队中 |
running | 生成中 |
succeeded | 生成成功 |
failed | 生成失败 |
cancelled | 已取消 |
expired | 已过期 |
