Seedance 视频生成 API：文生、图生、首尾帧、真人参考，一个接口都能做

Seedance 是字节 Doubao 系的视频生成模型。它在国内内容场景里很实用：中文提示词理解好、图生视频稳、还支持传真人照片做”角色参考”，让同一个人出现在全新场景里。

这篇讲怎么用 Ace Data Cloud 上的 Seedance API。接口是 POST https://api.acedata.cloud/seedance/videos，文档在 platform.acedata.cloud/documents/seedance-videos。到控制台拿一个 Token 就能调用，首次申请带免费额度。

先看真实成片和真实成本

下面这段是用 Seedance 跑出来的一段电影感短片（纸船在水面漂流的镜头）。这次调用平台记录的真实成本是 5.7 credits——不是估算，是这条请求实际扣的量。

📹 https://cdn.acedata.cloud/de34c29169.mp4

基本用法：文生视频

Seedance 的输入结构和别的视频接口略有不同——提示词、参考图、参考音视频都放在一个 content 数组里，每一项用 type 区分。最简单的文生视频只放一个 type: text：

curl -X POST 'https://api.acedata.cloud/seedance/videos' \
  -H 'authorization: Bearer {token}' \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -d '{
    "model": "doubao-seedance-2-0-fast-260128",
    "content": [
      {"type": "text", "text": "A white paper boat drifts on a calm dark water surface at dusk, cinematic reflection, gentle ripples, slow dolly-in, moody lighting."}
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "async": true
  }'

视频生成要 1–2 分钟，加 "async": true 立即拿到 task_id：

{
  "success": true,
  "task_id": "dc7cceb5-3c12-4de7-a5f4-abcbba3e8e39",
  "trace_id": "b3b09de3-b7fa-4bb0-88b5-aad4b4a96fd4"
}

然后向 /seedance/tasks 轮询，任务完成时 data.status 为 succeeded、data.video_url 就是成品：

curl -X POST 'https://api.acedata.cloud/seedance/tasks' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{"id": "dc7cceb5-3c12-4de7-a5f4-abcbba3e8e39", "action": "retrieve"}'

{
  "success": true,
  "task_id": "dc7cceb5-3c12-4de7-a5f4-abcbba3e8e39",
  "data": {
    "task_id": "cgt-20251222072003-x2259",
    "status": "succeeded",
    "video_url": "https://platform2.cdn.acedata.cloud/seedance/....mp4",
    "model": "doubao-seedance-2-0-fast-260128"
  }
}

图生视频：首帧 / 首尾帧

想让一张图动起来，在 content 里加 type: image_url 的项。注意 image_url 必须是对象格式 {"url": "https://..."}，不能直接传字符串，否则会 400。

只传一张 → 首帧模式，视频从这张图开始运动。传两张并分别标 role: first_frame 和 role: last_frame → 首尾帧模式，视频从第一张过渡到第二张：

{
  "model": "doubao-seedance-1-0-pro-250528",
  "content": [
    {"type": "text", "text": "360-degree shot"},
    {"type": "image_url", "role": "first_frame", "image_url": {"url": "https://.../first.jpg"}},
    {"type": "image_url", "role": "last_frame",  "image_url": {"url": "https://.../last.jpg"}}
  ]
}

全模态参考与视频编辑（Seedance 2.0 / 2.5）

Seedance 2.0 系列可组合角色、音频与视频参考；Seedance 2.5（doubao-seedance-2-5-260628）进一步支持最多 30 张参考图、10 段视频、10 段音频、纯音频参考，以及对参考视频进行编辑或延长。

{
  "model": "doubao-seedance-2-0-fast-260128",
  "content": [
    {"type": "text", "text": "The same woman wearing a beige coat walks through a sunny autumn park, golden leaves falling around her, she smiles softly at the camera, cinematic tracking shot."},
    {"type": "image_url", "role": "reference_image", "image_url": {"url": "https://.../portrait.jpg"}}
  ],
  "resolution": "720p",
  "ratio": "9:16",
  "duration": 5
}

几个要点：

首帧、首尾帧和全模态参考三种场景互斥：first_frame / last_frame 不能与 reference_image / reference_video / reference_audio 混用；
2.5 的 omni_reference_task_type 可设为 auto、reference、edit 或 extend；
请仅上传自有或已获授权的真人、角色与音视频素材。

如果你想让人物精确复刻照片里的构图（而不是”换个场景的同一个人”），改用 first_frame 让视频从这张照片开始运动即可。

常用参数速查

model：1.x、1.5、2.0 与 doubao-seedance-2-5-260628；
resolution：480p / 720p / 1080p，2.0 Standard 另支持 4k；
ratio：16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 / adaptive；
duration：2.0 为 4–15 秒，2.5 为 4–30 秒，均支持 -1 自动时长；
generate_audio：1.5 Pro 与 2.x 支持生成带声音的视频；
callback_url：异步回调地址，任务完成时平台把结果 POST 过去（也可以用 async + 轮询）。

用它做点什么

竖屏短视频：ratio: 9:16 直接出适配抖音/小红书的竖版，配合 2.0 的真人参考，可以让固定出镜人设批量出内容；
电商与产品：用首帧模式让产品图旋转/展示，或首尾帧模式做”形态变化”演示；
有声短片：用 doubao-seedance-1-5-pro-251215 + generate_audio 一步出带环境音的片子。

这些用法里，”稳定出镜的真人短视频”尤其值钱——它是内容账号最难持续供给的一环。把你用的工具链接放进主页，通过 Ace Data Cloud 创收联盟让通过你注册的用户消费产生返佣，是内容之外的一条收入；或者把这套异步生成流程包成工具，卖给需要批量做短视频的商家，成本就是平台按量计费的部分（比如上面那条 5.7 credits）。

参考链接

文档：https://platform.acedata.cloud/documents/seedance-videos
接口：POST https://api.acedata.cloud/seedance/videos
获取 Token：https://platform.acedata.cloud/console/applications

先用免费额度跑一条文生视频，再试试真人参考，你会对它能做什么有更具体的判断。