Seedance 视频生成 API 使用说明

概述

本服务提供 AI 视频生成能力，请求 / 响应采用类火山方舟（Volcengine Ark）的结构，支持三种生成模式：

快速开始

认证方式

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

Authorization: Bearer <你的 API Key>

基础信息

计费与余额

本服务采用预付费余额模式，请求前请确保账户余额充足。

计费规则

• 计费单位：积分。
  每个任务费用 = 视频时长（秒）× 该模型单价（积分/秒）。

冻结与扣费流程

1. 下单冻结：提交任务时，按预估费用冻结相应积分。
2. 成功扣费：任务成功后才实际扣费。
3. 解冻退回：任务失败 / 取消 / 超时则全额解冻，不扣费。

可用余额

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

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

余额查询与充值

• 余额查询：用你的 API Key 登录工作台 https://sd.boosterai.cn/#bill，查看实时余额、冻结金额与消费明细。
• 充值：请联系管理员。余额不足时请及时充值，否则无法继续提交任务。

可用模型列表

接口详情

1. 提交视频生成任务

请求体参数

content 数组元素说明

content 是一个数组，每个元素按 type 区分，本服务支持以下四种 type：

完整请求示例

下例演示文本 + 图片 + 视频 + 音频的多模态参考请求，可直接运行。文生视频、图生视频等场景只需按需增减 content 中的元素（text 项必填，其余参考媒体可选）。

多模态参考（seedance-2-fast，9:16，15 秒）：

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-fast",
    "content": [
      { "type": "text", "text": "保持视频中的动作和场景，参考图片中的人物风格，画面节奏跟随音频律动" },
      {
        "type": "image_url",
        "image_url": { "url": "https://example.com/reference.jpg" }
      },
      {
        "type": "video_url",
        "video_url": { "url": "https://example.com/source.mp4" }
      },
      {
        "type": "audio_url",
        "audio_url": { "url": "https://example.com/beat.mp3" }
      }
    ],
    "duration": 15,
    "ratio": "9:16"
  }'

响应示例

{
  "id": "task_01KWBW73D7WCN1PFZN9S1QQCK2"
}

HTTP 状态码

2. 查询单个任务状态

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

请求示例

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

响应示例（成功）

{
  "id": "task_01KWBW73D7WCN1PFZN9S1QQCK2",
  "model": "seedance-2",
  "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"
}

响应字段说明

响应示例（失败）

{
  "id": "task_01KWBW73D7WCN1PFZN9S1QQCK2",
  "status": "failed",
  "error": {
    "message": "模型处理失败，请重新提交"
  }
}

任务状态说明

HTTP 状态码

3. 查询任务列表

支持分页，返回当前 API Key 下的所有任务，按创建时间倒序排列。

查询参数

请求示例

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

响应示例

{
  "total": 42,
  "items": [
    {
      "id": "task_01KWBW73D7WCN1PFZN9S1QQCK2",
      "model": "seedance-2",
      "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"
    }
  ]
}

错误码参考