Seedance 视频生成 API 使用说明（官方版）

概述

本页为官方版接口说明。官方版与火山方舟（Volcengine Ark，火山引擎的大模型平台）官方口径完全对齐，按 token（模型计费的最小计量单位）计费。与「face 优化版」相互独立、互不影响。

• 请求体为火山原生的 content[] 结构，媒体项支持 role（角色，指定首帧/尾帧/参考图/参考视频/参考音频等用途）字段。
• 参数（分辨率、宽高比、时长、水印、音频、随机种子等）直接透传火山强校验：填错由火山返回错误提示，本服务不额外限制取值。
• 按 usage.total_tokens（本次任务的总 token 用量）计费，而非按视频秒数。

快速开始

认证方式

所有接口均需在请求头中传入 API Key：

Authorization: Bearer <你的 API Key>

基础信息

计费与余额（按 token）

官方版采用预付费余额模式，与 face 版共用同一个账户余额（单位：积分）。

计费规则

• 计费单位：积分。
  费用 = total_tokens ÷ 1,000,000 × 该模型单价（积分/百万 token）。

冻结与扣费流程

1. 下单冻结：提交任务时按预估 token 冻结相应积分。预估公式：预估token = 该分辨率最大像素面积 × 帧率(fps) × 预估秒数 ÷ 1024（向上取整）。含参考视频输入时预估秒数额外计入输入视频上限，冻结偏保守（偏高）。
2. 成功结算：任务成功后按上游返回的真实 usage.total_tokens 结算，多退少补（解冻预估额，按实际额扣费）。
3. 解冻退回：任务失败 / 取消 / 超时则全额解冻，不扣费。

可用余额

可用余额 = 账户总余额 − 冻结中金额

下单时若「可用余额 < 本次预估费用」，接口返回 402 insufficient_balance，任务不会提交。

余额查询与充值

• 余额查询：用你的 API Key 登录工作台 https://sd.boosterai.cn/#bill 查看实时余额、冻结金额与消费明细。
• 充值：请联系管理员。

可用模型列表

下游模型名（别名）由管理员配置，统一在官方名称后加 Official。各模型支持的分辨率能力如下（对齐火山官方文档）：

接口详情

1. 提交视频生成任务

请求体参数

官方版参数直接透传火山，本服务不额外做白名单/范围限制（填错由火山返回错误）。常用参数：

content 数组元素说明

每个元素按 type 区分，支持四种 type；媒体项可通过 role 指定用途（是否必填、取值合法性由火山校验）：

文生视频请求示例

curl -X POST https://sd.boosterai.cn/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer 你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Seedance 2.0 Official",
    "content": [
      { "type": "text", "text": "一只金色的猫咪在阳光下的草地上奔跑，电影质感，慢动作" }
    ],
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 10,
    "generate_audio": true
  }'

图生视频请求示例（指定首帧 + 尾帧）

curl -X POST https://sd.boosterai.cn/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer 你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Seedance 2.0 Official",
    "content": [
      { "type": "text", "text": "镜头从近景平滑推向远景" },
      { "type": "image_url", "role": "first_frame", "image_url": { "url": "https://example.com/start.jpg" } },
      { "type": "image_url", "role": "last_frame",  "image_url": { "url": "https://example.com/end.jpg" } }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 8
  }'

响应示例

{
  "id": "task_01KWBW73D7WCN1PFZN9S1QQCK2"
}

2. 查询单个任务状态

将提交任务时返回的 id 填入路径。

curl https://sd.boosterai.cn/api/v3/contents/generations/tasks/task_01KWBW73D7WCN1PFZN9S1QQCK2 \
  -H "Authorization: Bearer 你的APIKey"

响应示例（成功）

{
  "id": "task_01KWBW73D7WCN1PFZN9S1QQCK2",
  "model": "Seedance 2.0 Official",
  "status": "succeeded",
  "created_at": 1748900000,
  "updated_at": 1748900120,
  "content": { "video_url": "https://cdn.example.com/output/video.mp4" },
  "duration": 10,
  "resolution": "1080p",
  "ratio": "16:9"
}

任务状态说明

3. 查询任务列表

支持分页，返回当前 API Key 下的所有任务（含两版），按创建时间倒序。参数：page_num（默认 1）、page_size（默认 10）。

curl "https://sd.boosterai.cn/api/v3/contents/generations/tasks?page_num=1&page_size=20" \
  -H "Authorization: Bearer 你的APIKey"

错误码参考