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

概述

本页为绘蛙版接口说明，按视频时长（秒）计费。

• 请求体为 content[] 结构，媒体项支持 role（角色，指定首帧/尾帧/参考图/参考视频/参考音频等用途）字段。
• 绘蛙版只支持视频生成任务；resolution（分辨率）为必传字段，其余参数（宽高比、时长、音频等）按各模型能力白名单校验。
• 按视频真实时长（秒）计费：费用 = 时长 × 该模型单价（积分/秒）。
• 任务状态透出为 queued / running / succeeded / failed 等，上游状态由本服务统一映射，客户无需感知。

快速开始

认证方式

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

Authorization: Bearer <你的 API Key>

基础信息

计费与余额（按秒）

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

计费规则

• 计费单位：积分。
  费用 = 计费时长（秒）× 该模型单价（积分/秒）。
  计费时长 = 视频真实时长 + 参考视频合计时长 × 计费系数（content 中 video_url 项，由服务端探测，每个视频向下取整到整秒；系数由管理员按客户配置，默认为 1 即全价计入）。

冻结与扣费流程

1. 下单冻结：提交任务时按预估秒数 冻结相应积分。预估秒数取你传入的 duration。
2. 成功结算：任务成功后按上游返回的真实时长结算，多退少补（解冻预估额，按实际额扣费）。
3. 解冻退回：任务失败 / 取消 / 超时则全额解冻，不扣费。

可用余额

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

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

余额查询与充值

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

可用模型列表

绘蛙版模型名统一为小写连字符风格、以 -hw 结尾，各模型支持的能力：

接口详情

1. 提交视频生成任务

请求体参数

常用参数（绘蛙版 resolution 必传，其余参数取值按模型能力白名单校验）：

content 数组元素说明

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

参考媒体限制（Seedance 2.0 系列）

本服务不额外校验，超限由上游返回错误。媒体文件需为公网可访问 URL，大文件请勿使用 Base64 编码（整个请求体不超过 64 MB）：

文生视频请求示例

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-hw",
    "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-hw",
    "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-hw",
  "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"

错误码参考