本页仅说明 Seedance2.0。若调用fast / mini / 2.5 系列（Seedance2.0 / fast / mini / 2.5），请打开 fast / mini / 2.5 系列文档。

Seedance2.0 API

请求体里 model 填 Seedance2.0。有参考图/音/视频时，先把公网 URL 入库，待 Active 后再创建任务。计费按秒：分辨率单价 × 时长。

1. 概述

Bearer sk- │ ├─ POST /api/v3/assets （公网 URL 入库） │ └─ 轮询至 Active │ └─ POST …/contents/generations/tasks model = Seedance2.0 resolution + duration + content（引用素材 Id） → 立即按「单价×秒」冻结 → GET 轮询；成功取成片短链（约 24h）

2. 接入步骤

控制台创建视频 API Key（sk-…）。
若用素材 OpenAPI 签名，再创建素材 Access Key / Secret；走素材 REST 时只用 sk- 即可。
视频 Base：本站 /api/v3。
创建任务时 model 必须为 Seedance2.0，分辨率写在 resolution。

3. 域名

视频 / 素材 REST： https://hub.jumustudio.com/api/v3

素材 OpenAPI Host： https://hub.jumustudio.com （根域名，无 /api/v3）

4. 鉴权

Authorization: Bearer sk-xxxxxxxx

创建任务须带请求头 Idempotency-Key（同 key 同 body 约 24h 内只真正创建一次；不传返回 400）。

素材 OpenAPI 使用本站 AK/SK 做 Signature V4（Host 必须是本站域名）。

5. 素材入库

把图片/视频/音频放到你自己的公网 HTTPS 地址。
调用入库接口，Body 带该 URL。
状态：Processing → Active / Failed。
Active 后，在视频 content 里填素材 Id，或 asset://{Id}。
未 Active 就创建任务 → asset_not_ready。

正式对接请用公网 URL 入库。控制台本地上传仅试用。

status	含义	能否用于生成
`Processing`	处理中	否
`Active`	可用	是
`Failed`	失败	否

6. 素材接口

REST（推荐，同一把 sk-）

POST /api/v3/assets — {"url","bind_name?","asset_type?"}

GET /api/v3/assets / /api/v3/assets/{id}

POST /api/v3/assets/{id}/refresh

DELETE /api/v3/assets/{id}

OpenAPI（可选，AK/SK）

POST /?Action=CreateAsset&Version=2024-01-01，Body 含 URL、AssetType 等。

7. 视频任务

POST /api/v3/contents/generations/tasks — 创建

GET /api/v3/contents/generations/tasks/{id} — 查询

GET /api/v3/contents/generations/tasks — 列表

不提供 DELETE …/tasks/{id}（已关闭，防误删）。

字段	说明
`model`	固定 `Seedance2.0`
`resolution`	`480p` / `720p` / `1080p`
`duration`	秒；参与计费
`ratio`	如 `16:9` / `9:16`
`content`	text + 素材 Id / `asset://…`
`generate_audio` / `watermark`	布尔

8. 计费

单位：积分。充值按人民币结算，1 积分对应 1 元人民币本站消费额度（不可提现、不可转让）。单价以控制台 / 商务约定为准。
公式：冻结金额 = 该分辨率单价 × duration（秒）。
提交即冻结；创建失败或任务 failed / cancelled / expired → 退回；succeeded → 核销。
成片成功后链接过期未下载不退。
成片短链约 24 小时有效；本站不转存、不续签。
流水字段 model 为 Seedance2.0，便于按产品汇总。

9. 余额与对账

GET /api/v3/account/balance

GET /api/v3/account/ledger

GET /api/v3/account/billing/months · …/entries · …/export

对账时筛 model=Seedance2.0。

10. 常见错误码

code	说明
`unauthorized`	Key 无效
`insufficient_balance`	余额不足
`unknown_model`	模型未开放
`asset_not_ready`	素材未 Active
`asset_failed`	素材失败
`invalid_request`	参数不合法
`rate_limited`	过于频繁

11. 完整示例

BASE=https://hub.jumustudio.com/api/v3
KEY=sk-你的视频Key

# 1) 入库
curl "$BASE/assets" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://你的公网/face.jpg","bind_name":"主角","asset_type":"Image"}'

# 2) 创建（待素材 Active）
curl "$BASE/contents/generations/tasks" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Seedance2.0",
    "resolution": "720p",
    "ratio": "9:16",
    "duration": 8,
    "generate_audio": true,
    "watermark": false,
    "content": [
      {"type":"text","text":"人物自然眨眼，镜头缓慢推进"},
      {"type":"image_url","image_url":{"url":"上一步素材Id"},"role":"reference_image"}
    ]
  }'

# 3) 轮询
curl "$BASE/contents/generations/tasks/{task_id}" \
  -H "Authorization: Bearer $KEY"

← 文档首页 fast / mini / 2.5 系列文档打开 Studio 控制台