火山方舟视频 · Seedance
方舟视频 · Seedance 系列
适用 modelKey:
| modelKey | 代际 |
|---|---|
doubao-seedance-1.5-pro | 1.5 |
doubao-seedance-1.0-pro | 1.0 pro |
doubao-seedance-1.0-pro-fast | 1.0 pro fast |
doubao-seedance-2.0 | 2.0 |
doubao-seedance-2.0-fast | 2.0 fast |
命名说明:上表为 JELLYTOKEN modelKey,可能不同于火山方舟官方 Model ID;调用时以控制台 /
GET /api/ai/models返回为准。
推荐接入
示例(文生视频)
export API_KEY="uas_你的密钥"
export API_BASE_URL="https://aiservice.jellytoken.com"
TASK=$(curl -s -X POST "$API_BASE_URL/api/ai/tasks" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"modelKey": "doubao-seedance-2.0",
"callbackId": "seedance-001",
"videoParams": {
"prompt": "无人机掠过雪山,电影感",
"duration": 5,
"resolution": "720p",
"aspectRatio": "16:9"
}
}')
echo "$TASK"
TASK_ID=$(echo "$TASK" | jq -r .taskId)
curl -s "$API_BASE_URL/api/ai/tasks/$TASK_ID" \
-H "Authorization: Bearer $API_KEY" | jq .
status=completed 时从 resultUrlPublic 取视频地址。建议每 2~5 秒轮询,或使用 Webhook 回调。
平台入参
| 字段 | 说明 |
|---|---|
videoParams.prompt | 提示词 |
videoParams.firstFrame / lastFrame | 首尾帧 |
videoParams.refImages | 多模态参考(Seedance 2.0) |
videoParams.duration | 时长;Seedance 2.0 可传 -1 使用智能时长 |
videoParams.resolution | 如 720p、1080p |
videoParams.aspectRatio | 映射到方舟 ratio,如 16:9、9:16、adaptive |
videoParams.extraParamsJson | 平台已支持的 Seedance 特有字段,如参考视频、参考音频、工具配置 |
完整字段见 平台异步任务 API(视频)。
首帧/首尾帧(
firstFrame/lastFrame)与多模态参考(refImages、extraParamsJson.refVideos、extraParamsJson.refAudios)属于不同生成模式,建议不要在同一次请求中混用。
平台字段映射
extraParamsJson 必须是 JSON 字符串;当前平台会解析为对象后按模型能力映射:
| 字段 | 映射说明 | 默认值 / 约束 |
|---|---|---|
videoParams.prompt | 生成 content[].type=text | 必填(除非使用 draft_id) |
videoParams.firstFrame / lastFrame | 生成 content[].role=first_frame / last_frame | 与多模态参考互斥 |
videoParams.refImages | Seedance 2.0 多模态参考图 | 最多 9 张;与首尾帧互斥 |
extraParamsJson.refVideos | Seedance 2.0 参考视频 | 最多 3 个;与首尾帧互斥 |
extraParamsJson.refAudios | Seedance 2.0 参考音频 | 最多 3 段;需同时有参考图或视频 |
videoParams.duration | 映射到方舟 duration | Seedance 2.0 可传 -1(智能时长) |
videoParams.aspectRatio | 映射到方舟 ratio | 如 16:9、9:16、adaptive |
extraParamsJson.draft_id | 映射为方舟 draft_task | 使用草稿时可不传 prompt |
extraParamsJson.generate_audio | 映射到方舟同名字段 | 默认 true |
extraParamsJson.return_last_frame | 映射到方舟同名字段 | 默认 false |
extraParamsJson.tools | 映射到方舟同名字段 | 仅保留 web_search(Seedance 2.0) |
extraParamsJson.watermark | 映射到方舟同名字段 | 默认 false |
平台出参
查单 status=completed 时从 resultUrlPublic 取视频 URL;Webhook 见 Webhook 回调。
厂商全量参数
| 文档 | 说明 |
|---|---|
| 创建视频生成任务 API | 创建任务 |
| 查询视频生成任务 API | 查询任务 |
| 查询视频生成任务列表 | 列表 |
| 取消或删除视频生成任务 | 取消/删除 |
| 视频生成教程 | 教程 |
| Doubao Seedance 2.0 教程 | 2.0 教程 |
| Seedance 2.0 提示词指南 | 2.0 提示词 |
| Seedance 1.5 Pro 提示词指南 | 1.5 提示词 |