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

概述

本页为贞贞版接口说明，按 token（模型计费的最小计量单位）计费。

• 请求体为 content[] 结构，本服务按模型名后缀区分任务类型：-t2v 文生视频 / -i2v 图生视频 / -multi 多模态视频。
• 参数（分辨率、宽高比、时长、音频、随机种子等）直接透传上游强校验：填错由上游返回错误提示，本服务不额外限制取值。
• 按 token 计费；含参考视频输入时按「含视频」档单价计费。
• 任务状态透出为 queued / running / succeeded / failed 等，上游状态由本服务统一映射，客户无需感知。

快速开始

认证方式

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

Authorization: Bearer <你的 API Key>

基础信息

计费与余额（按 token）

贞贞版采用预付费余额模式（单位：积分），请求前请确保账户余额充足。

计费规则

• 计费单位：积分。
  费用 = tokens ÷ 1,000,000 × 该模型该档单价（积分/百万 token）。单价按「分辨率档 × 是否含参考视频输入」分档，以管理员配置为准。

冻结与扣费流程

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

可用余额

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

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

余额查询与充值

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

可用模型列表

下游模型名（别名）由管理员配置。模型名后缀决定任务类型：-t2v 文生视频 / -i2v 图生视频 / -multi 多模态视频。各档位支持的分辨率能力：

接口详情

1. 提交视频生成任务

请求体参数

请求体为 content[] 结构，常用参数：

content 数组元素说明

每个元素按 type 区分。本服务按模型后缀映射：-t2v 只取 text；-i2v 取 text + 图片项（第 1 张为首帧、第 2 张为尾帧，按数组顺序，role 不参与判定）；-multi 取 text + 全部媒体项（图片/视频/音频混合，提示词里可用 @Image 1、@Video 1 指代第几个素材）：

参考媒体限制

本服务不额外校验，超限由上游返回错误。媒体文件需为公网可访问 URL：

文生视频请求示例（-t2v）

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-mini-t2v-zz",
    "content": [
      { "type": "text", "text": "一只金色的猫咪在阳光下的草地上奔跑，电影质感，慢动作" }
    ],
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 10,
    "generate_audio": true
  }'

图生视频请求示例（-i2v，首帧 + 尾帧）

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-standard-i2v-zz",
    "content": [
      { "type": "text", "text": "镜头从近景平滑推向远景" },
      { "type": "image_url", "image_url": { "url": "https://example.com/start.jpg" } },
      { "type": "image_url", "image_url": { "url": "https://example.com/end.jpg" } }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 8
  }'

多模态请求示例（-multi，把视频中的人物换成图片中的人物）

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-standard-multi-zz",
    "content": [
      { "type": "text", "text": "把 @Video 1 中的人物替换成 @Image 1 中的人物" },
      { "type": "image_url", "image_url": { "url": "https://example.com/person.png" } },
      { "type": "video_url", "video_url": { "url": "https://example.com/source.mp4" } }
    ],
    "resolution": "1080p",
    "duration": 5
  }'

响应示例

{
  "id": "task_01KWBW73D7WCN1PFZN9S1QQCK2"
}

2. 查询单个任务状态

将提交任务时返回的 id 填入路径。建议每 3~5 秒轮询一次。

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

响应示例（成功）

{
  "id": "task_01KWBW73D7WCN1PFZN9S1QQCK2",
  "model": "seedance-2.0-mini-t2v-zz",
  "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"

图片生成（文生图 / 图生图 / 图层拆分）

与视频接口一样采用「提交 → 轮询」异步模式，独立端点、独立模型名。图片任务按上游实际消费计费：提交时按预估价全额冻结，成功后按实际消费多退少补，失败全额解冻。

可用图片模型

4. 提交图片生成任务

请求体参数

# 文生图
curl -X POST "https://sd.boosterai.cn/api/v3/images/generations" \
  -H "Authorization: Bearer 你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-v5-pro-t2i-zz",
    "prompt": "高端护肤品电商主图，纯白柔光展台，玻璃精华瓶",
    "metadata": {"resolution": "2k", "output_format": "jpeg"}
  }'

# 图生图
curl -X POST "https://sd.boosterai.cn/api/v3/images/generations" \
  -H "Authorization: Bearer 你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-v5-pro-i2i-zz",
    "prompt": "横版复古馆藏风美妆宣传海报，藏青深蓝色哑光底",
    "images": ["https://your-cdn.example.com/ref.png"],
    "metadata": {"resolution": "1k"}
  }'

{
  "id": "task_xxxxxxxxxxxx",
  "model": "seedream-v5-pro-t2i-zz",
  "status": "SUCCEEDED",
  "result_url": "https://.../base.jpg",
  "image_urls": ["https://.../base.jpg", "https://.../layer-1.png"]
}