跳转到主要内容
POST
/
seedance
/
api
/
v3
/
contents
/
generations
/
tasks
创建 Seedance 2.0 视频生成任务
curl --request POST \
  --url https://api.apiyi.com/seedance/api/v3/contents/generations/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedance-2-0-fast-260128",
  "content": [
    {
      "type": "text",
      "text": "无人机航拍视角飞越秋天的山谷，金黄色的森林和蜿蜒的河流，电影感"
    }
  ]
}
'
{
  "id": "cgt-20260606160057-6bbjd"
}
右侧 Playground 可直接调试：在 Authorization 填 Bearer sk-your-api-key（令牌须勾选 SeeDance2 分组），填好 model / content 后发起请求。提交成功返回任务 id，后续轮询与下载见下方代码示例。
关于 Playground 报「请求时发生错误: no response received」：本接口是异步任务式端点，在浏览器里点「发送」可能出现此提示——这是浏览器的跨域安全校验拦截了响应，任务实际已成功提交到后台（可用下方查询接口或控制台日志验证）。此外 Playground 仅能创建任务、无法完成轮询与下载视频。要跑通完整的「创建 → 轮询 → 下载」流程，请直接复制下方 代码示例（cURL / Python / Node.js）运行。
本页是 Seedance 2.0 的创建任务接口，文生视频、首帧/首尾帧、多模态参考共用同一端点，靠 content 数组区分模式。模型选型、定价、分辨率像素表、FAQ 见 Seedance 2.0 概览。
  • 路径前缀是 /seedance/api/v3，不要漏掉 /api，也不要用 /v1/videos
  • 令牌必须勾选 SeeDance2 分组，否则报「该模型无可用渠道」
  • generate_audio 默认 true（输出带声音），不需要请显式传 false
  • Python requests 需加请求头 "Accept-Encoding": "identity"，否则报 gzip 解码错误
  • 成功状态是 succeeded（不是 completed），视频地址在 content.video_url，24 小时过期

​
代码示例

curl -X POST "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast-260128",
    "content": [
      {"type": "text", "text": "无人机航拍视角飞越秋天的山谷，金黄色的森林和蜿蜒的河流，电影感"}
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": false
  }'
# 返回：{"id":"cgt-2026xxxx-xxxxx"}，拿 id 轮询查询接口

​
参数说明速查

参数类型必填默认说明
modelstring✓—doubao-seedance-2-0-260128（标准版，支持 1080p）/ doubao-seedance-2-0-fast-260128（极速版，最高 720p）。写纯 ID，不要带 ep- 前缀
contentarray✓—输入信息数组，见下方「生成模式」
resolutionstring720p480p / 720p / 1080p（fast 不支持 1080p）
ratiostringadaptive16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive；同档位全比例同价
durationint54–15 整数秒；-1 模型智能选时长（按实际产出计费）
generate_audiobooltrue是否生成同步音频（人声/音效/配乐，单声道）
watermarkboolfalse是否加「AI 生成」水印
seedint-1[-1, 2^32-1]；相同 seed 生成类似（不保证一致）结果
return_last_frameboolfalse返回尾帧 png（无水印），用于多段视频接力
execution_expires_afterint172800任务过期阈值（秒），范围 [3600, 259200]
Seedance 2.0 不支持 frames、camera_fixed、service_tier（仅在线推理）参数——这些是 Seedance 1.x 的能力，传入会被忽略或报错。

​
生成模式（content 组合）

模式content 组成role 取值
文生视频1 个 text—
图生视频-首帧text（可选）+ 1 个 image_urlfirst_frame 或不填
图生视频-首尾帧text（可选）+ 2 个 image_url必填 first_frame / last_frame
多模态参考text + 1–9 个 image_url（+ 可选 video_url / audio_url）reference_image / reference_video / reference_audio
三种图生场景互斥。图片支持公网 URL、Base64（data:image/png;base64,...）、素材 ID（asset://...）；不支持含真人人脸的输入素材。音频需与至少 1 个图片或视频一起传。

​
响应格式

创建成功只返回任务 ID（不是视频本身）： 
{ "id": "cgt-20260606160057-6bbjd" }
轮询 GET /seedance/api/v3/contents/generations/tasks/{id}，成功后的完整响应（实测样本）： 
{
  "id": "cgt-20260606160057-6bbjd",
  "model": "doubao-seedance-2-0-fast-260128",
  "status": "succeeded",
  "content": {
    "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/....mp4?X-Tos-Expires=86400&..."
  },
  "usage": { "completion_tokens": 108900, "total_tokens": 108900 },
  "created_at": 1780732857,
  "updated_at": 1780732991,
  "seed": 97151,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "framespersecond": 24,
  "generate_audio": true,
  "draft": false
}
  • 视频地址在 content.video_url，不在顶层；签名直链 24 小时过期，成功后立即下载转存
  • 状态机：queued → running → succeeded / failed / expired，成功是 succeeded
  • 下载视频时直接 GET 直链即可，不要带 Authorization 头
usage.completion_tokens 即计费 token 数，满足 token ≈ 时长 × 宽 × 高 × 24 / 1024（实测偏差少于 0.1%）。duration: -1 或 ratio: adaptive 时，实际时长与比例以响应中的 duration / ratio 字段为准。

授权

​
Authorization
string
header
必填

在 API易控制台获取的 API Key（令牌须勾选 SeeDance2 分组）

请求体

application/json
​
model
enum<string>
必填

模型 ID（写纯 ID，不要带 ep- 前缀）。标准版支持 1080p；fast 最高 720p，生成更快，站内同价

可用选项:
doubao-seedance-2-0-260128,
doubao-seedance-2-0-fast-260128
示例:

"doubao-seedance-2-0-fast-260128"

​
content
object[]
必填

输入信息数组。文生视频只放 1 个 text；图生视频追加 image_url（role: first_frame / last_frame）；多模态参考追加 1-9 个 image_url（role: reference_image），可再加 video_url / audio_url。三种图生场景互斥

​
resolution
enum<string>
默认值:720p

分辨率档位（定义像素面积，同档位全比例同价）。fast 不支持 1080p

可用选项:
480p,
720p,
1080p
​
ratio
enum<string>
默认值:adaptive

宽高比。adaptive 按输入自动适配（图生视频推荐，避免裁剪）；实际比例见查询响应 ratio 字段

可用选项:
16:9,
4:3,
1:1,
3:4,
9:16,
21:9,
adaptive
​
duration
integer
默认值:5

视频时长（整数秒），4-15；或 -1 由模型智能选择（按实际产出计费）。费用与时长线性相关

示例:

5

​
generate_audio
boolean
默认值:true

是否生成与画面同步的音频（人声/音效/背景音乐，单声道）。注意默认 true，不需要声音时显式传 false

​
watermark
boolean
默认值:false

是否在右下角加「AI 生成」水印

​
seed
integer
默认值:-1

随机种子，[-1, 2^32-1]。相同 seed 生成类似（不保证一致）结果；-1 表示随机

​
return_last_frame
boolean
默认值:false

是否返回尾帧 png（无水印、与视频同宽高），用于把尾帧作为下一段任务首帧、量产连续视频

​
execution_expires_after
integer
默认值:172800

任务过期阈值（秒），超时任务标记为 expired。范围 [3600, 259200]

响应

任务创建成功，返回任务 ID（用于轮询查询）

任务创建成功响应。拿 id 轮询 GET /seedance/api/v3/contents/generations/tasks/{id}；任务成功后视频地址在 content.video_url（24 小时过期），计费 token 在 usage.completion_tokens

​
id
string

视频生成任务 ID（保存 7 天）

示例:

"cgt-20260606160057-6bbjd"