本页说明 fast / mini / 2.5（公网 URL 直传）。若调用 Seedance2.0，请打开 Seedance2.0 文档。

fast / mini / 2.5 API

请求体里 model 填 fast、mini 或 2.5。素材直接写公网 HTTPS URL，不需要素材库，也不需要 AK/SK。 fast / mini 按次计费；2.5 按秒计费（单价 × duration）。同一把 sk- 可调用本系列全部模型。

本产品不提供素材入库接口说明。请勿套用 Seedance 的入库流程。视频任务不提供删除接口：请轮询至终态；失败/取消/过期会自动退回冻结。

1. 概述

Bearer sk- │ └─ POST …/contents/generations/tasks model = fast | mini | 2.5 resolution + content（公网 HTTPS URL） → 按次模型：次价冻结；2.5：单价×duration 冻结 → GET 轮询；成功取成片短链（约 24h）

2. 接入步骤

控制台创建视频 API Key（sk-…）。到此即可，不必创建素材 AK/SK。
视频 Base：本站 /api/v3。
创建任务时 model 填下方三选一，分辨率写在 resolution（须在该模型支持范围内）。
参考素材放进 content，使用可公网访问的 HTTPS 链接。

3. 域名

API Base： https://hub.jumustudio.com/api/v3

4. 鉴权

Authorization: Bearer sk-xxxxxxxx

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

不需要素材 OpenAPI，也不需要 AK/SK。

5. 视频任务

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

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

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

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

字段	说明
`model`	`fast` / `mini` / `2.5`
`resolution`	见下表；决定单价档
`content`	text + 公网 HTTPS 图片/音频/视频 URL
`duration` / `ratio` 等	按次模型可不乘 duration；`2.5` 的 duration（4–30 秒）参与计费

model	支持分辨率	计费
`fast`	仅 `720p`	按次
`mini`	`480p` / `720p`	按次
`2.5`	仅 `720p`；时长 4–30 秒	按秒（× duration）

参考素材上限

content 中可同时带图片 / 音频 / 视频公网 HTTPS URL（不必入库）。超限返回 400 invalid_request。

model	图片	视频	音频	合计
`fast` / `mini`	≤ 9	≤ 3	≤ 3	≤ 15
`2.5`	≤ 30	≤ 10	≤ 10	≤ 50

{
  "model": "fast",
  "resolution": "720p",
  "content": [
    {"type":"text","text":"人物自然眨眼，镜头缓慢推进"},
    {"type":"image_url","image_url":{"url":"https://你的公网/face.jpg"}}
  ]
}

6. 计费

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

7. 余额与对账

GET /api/v3/account/balance

GET /api/v3/account/ledger

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

对账时可按 model 筛选（含 2.5）。按次模型勿按「秒」理解金额；2.5 按秒。

8. 常见错误码

code	说明
`unauthorized`	Key 无效
`insufficient_balance`	余额不足
`unknown_model`	模型未开放
`invalid_request`	参数不合法（如 URL 无效）
`rate_limited`	过于频繁

9. 完整示例

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

curl "$BASE/contents/generations/tasks" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fast",
    "resolution": "720p",
    "content": [
      {"type":"text","text":"人物自然眨眼，镜头缓慢推进"},
      {"type":"image_url","image_url":{"url":"https://你的公网/face.jpg"}}
    ]
  }'

curl "$BASE/contents/generations/tasks/{task_id}" \
  -H "Authorization: Bearer $KEY"

← 文档首页 Seedance2.0 文档打开 Studio 控制台