DEVELOPER API

生产接入

当前账号

视频生成接口说明

下面的格式可以直接交给第三方开发者。生产调用必须在对方自己的服务端完成，Secret 不要放在浏览器或客户端。

下载 API 文档

模型与价格GET /v1/pool/api/models

接口发现GET /v1/pool/api/discovery

提交视频任务POST /v1/pool/api/tasks

查询任务状态GET /v1/pool/api/tasks/{taskId}

下载生成结果GET /v1/pool/api/tasks/{taskId}/result

取消未完成任务POST /v1/pool/api/tasks/{taskId}/cancel

1. 接口地址

POST https://1456719883-78ndn27wdv.ap-guangzhou.tencentscf.com/v1/pool/api/tasks

2. 鉴权方式

请求头需要携带注册后生成的 Key ID、时间戳、随机数、幂等键和 HMAC-SHA256 签名：

X-Wangyue-Key-Id: YOUR_KEY_ID
X-Wangyue-Timestamp: 1776936222
X-Wangyue-Nonce: a-unique-random-string
X-Idempotency-Key: task-20260819-0001
X-Wangyue-Signature: YOUR_HMAC_SHA256_SIGNATURE

签名原文按以下 6 行拼接：METHOD、PATH_WITH_SORTED_QUERY、TIMESTAMP、NONCE、IDEMPOTENCY_KEY、SHA256(STABLE_JSON_BODY)。使用 Secret 做 HMAC-SHA256，结果输出小写十六进制。时间戳允许的时钟偏差和完整字段可通过 GET /v1/pool/api/discovery 获取。

const bodyText = stableJson(body); // 递归按键名排序，数组顺序保持不变
const bodyHash = crypto.createHash('sha256').update(bodyText).digest('hex');
const canonical = [method, path, timestamp, nonce, idempotencyKey, bodyHash].join('\n');
const signature = crypto.createHmac('sha256', SECRET).update(canonical).digest('hex');

3. 文生视频

{
  "type": "doubao_video",
  "idempotencyKey": "task-20260819-0001",
  "payload": {
    "projectId": "demo-project",
    "episodeId": "episode-1",
    "shotId": "shot-1",
    "rowId": "shot-1",
    "prompt": "雨夜霓虹街道，镜头缓慢推进，电影感光影",
    "settings": {
      "model": "seedance2.0fast",
      "duration": 10,
      "aspectRatio": "16:9",
      "resolution": "720P"
    }
  }
}

4. 图生视频

先调用素材租约接口获得 assetId，将图片上传并确认后，把它放进 referenceAssetIds。图片总数最多 9 张。

POST /v1/pool/api/assets/input/lease

{
  "fileName": "reference.jpg",
  "contentType": "image/jpeg",
  "byteSize": 123456
}

POST /v1/pool/api/tasks

{
  "type": "doubao_video",
  "idempotencyKey": "task-20260819-0002",
  "payload": {
    "projectId": "demo-project",
    "rowId": "shot-2",
    "prompt": "保持人物外貌和服装一致，自然缓慢走动",
    "referenceAssetIds": ["ASSET_ID_FROM_UPLOAD_LEASE"],
    "settings": {
      "model": "seedance2.0mini",
      "duration": 15,
      "aspectRatio": "9:16",
      "resolution": "720P",
      "referenceMode": "start_frame"
    }
  }
}

5. 返回与查询任务状态

{
  "ok": true,
  "task": {
    "id": "TASK_UUID",
    "status": "queued",
    "submissionState": "not_submitted",
    "progressStatus": ""
  }
}

GET /v1/pool/api/tasks/TASK_UUID

状态包括 queued、leased、review_required、completed、failed、cancelled。状态为 completed 后调用结果接口下载视频：

GET /v1/pool/api/tasks/TASK_UUID/result

6. 两个公开模型

seedance2.0fast：速度优先，默认 10 秒；seedance2.0mini：轻量模型，默认 15 秒。具体价格以 GET /v1/pool/api/models 返回值为准，管理员在管理中心调整价格后会立即反映到新任务的报价与结算。

7. 参数说明

参数	类型	必填	说明
settings.model	string	是	`seedance2.0fast` 或 `seedance2.0mini`
prompt	string	是	视频描述提示词
settings.aspectRatio	string	否	`16:9`、`9:16`、`4:3`、`3:4`、`1:1`
settings.resolution	string	否	当前为 `720P`
settings.duration	number	否	fast 默认 10 秒，mini 默认 15 秒
referenceAssetIds	array	否	已上传到号池的私有素材 ID，最多 9 个
idempotencyKey	string	是	客户端重试时保持不变，避免重复扣费和重复任务

8. 使用说明

注册账号 → 创建生产凭证 → 保存 Key ID 和 Secret → 使用服务端 HMAC 签名提交任务 → 保存任务 ID → 轮询任务状态 → 完成后下载结果。Webhook 完全可选，不影响提交、轮询和下载。

MODEL CATALOG

豆包号池模型

公开目录只包含这两个模型。价格、时长和能力来自服务端实时目录。

两步接入豆包号池

接入望月视频生成 API