Seedance 2.0 接口文档

同时开放 Fast 极速版与 Standard 标准版(4–15 秒):480p/720p 跑量选极速版省 39%,商业成片选标准版最高支持 4K,均含原生音画同步。

POST /v1/videos/generations

公开模型 ID 与生成模式

双档位 4–15 秒视频家族:日常跑量推荐 seedance-2.0-fast-*(480p / 720p,比标准版省约 39%);需要 1080p 或 "4k" 超清画质时调用 seedance-2.0-*。

纯文生视频传入 *-text-to-video 模型 ID;图生视频传入 *-image-to-video 并在 image_urls 中传入 1 张首帧或 2 张首尾帧 HTTPS 图片链接。文生与图生每秒单价一致,内置原生音画同步无附加费。

公开 Model ID生成模式必填字段
seedance-2.0-fast-text-to-videoFast 极速版文生视频(480p / 720p · 比标准版省 39%)prompt
seedance-2.0-fast-image-to-videoFast 极速版首尾帧图生视频(480p / 720p)prompt + image_urls (1..2)
seedance-2.0-text-to-videoStandard 标准版文生视频(最高支持 4K)prompt
seedance-2.0-image-to-videoStandard 标准版首尾帧图生视频(最高支持 4K)prompt + image_urls (1..2)

请求参数说明

未登记的顶层字段会在冻结积分前直接返回 HTTP 400 invalid_parameter。调用 *-image-to-video 图生视频时,aspect_ratio 请省略或传 "adaptive"(画幅自动跟随输入首帧)。

参数字段类型与默认值取值范围与说明
Authorization
必填Header
string
Bearer cm_live_... 格式的服务端 API Key。
Idempotency-Key
可选Header
string默认: recommended
1 至 255 位 ASCII 字符;24 小时内及任务完成前防止重复提交与重复扣费。
model
必填
"seedance-2.0-fast-*" | "seedance-2.0-*"
选择文生视频(text-to-video)或首尾帧图生视频(image-to-video)公开 ID。
prompt
必填
string
非空 UTF-8 镜头画面、动作与音频描述提示词。
image_urls
可选
string[] (1..2)默认: required on I2V
图生视频模式必填 1 张首帧或 2 张首尾帧 HTTPS 图片链接(不加收参考图费)。
quality
可选
Fast: "480p" | "720p"; Std: + "1080p" | "4k"默认: "720p"
输出视频清晰度档位,决定每秒积分单价。
duration
可选
integer (4..15s)默认: 5
请求时长(4..15s)。最低 4.0 秒起算,完成后按实际输出时长精确至 0.1 秒退差结算。
aspect_ratio
可选
"16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "21:9" | "adaptive"默认: "adaptive"
文生视频支持全部 7 种比例;图生视频仅支持 "adaptive"(自适应首帧尺寸)。
generate_audio
可选
boolean默认: true
原生音画同步音效与对白开关,默认开启且无附加费。
output_format
可选
"mp4" | "mov"默认: "mp4"
输出视频容器格式,通过 30 天有效 HTTPS 链接返回。

提交与轮询代码示例

视频生成耗时通常在 20 至 90 秒之间。建议每 3–5 秒轮询一次 GET /v1/tasks/:task_id,直至 status 变为 completed 或 failed。

curl -sS -X POST "https://api.callmodels.dev/v1/videos/generations" \
  -H "Authorization: Bearer $CALLMODELS_API_KEY" \
  -H "Idempotency-Key: vid_t2v_20261115_01" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2.0-fast-text-to-video",
  "prompt": "A smooth tracking shot along wet volcanic coastline at sunrise with natural surf audio",
  "quality": "720p",
  "duration": 5,
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "output_format": "mp4"
}'

响应结构示例

任务完成后返回 https://files.callmodels.dev 下的 30 天有效 HTTPS 下载链接与精确结算的 cost_credits。

{
  "id": "task_01e561ba-859e-47fe-be79-60bc6f1d6499",
  "model": "seedance-2.0-fast-text-to-video",
  "object": "video.generation.task",
  "status": "pending",
  "created_at": "2026-11-15T09:49:18.000Z"
}

每秒单价与 0.1 秒精确计费

提交请求时按 duration × 每秒单价 预扣上限;生成完成后按实际输出时长向上取整至 0.1 秒 结算(最低 4.0 秒 起算,不超过请求秒数),未用完的预扣积分立即退回可用余额。

规格档位Callmodels 积分折合美元官方参考价
Fast 极速版 · 480p · 文生 / 首尾帧(5秒 = 26.85 积分)5.369404 积分 / 秒$0.0537 / s$0.075 / s
Fast 极速版 · 720p · 文生 / 首尾帧(5秒 = 57.73 积分)11.546967 积分 / 秒$0.1155 / s$0.161 / s
Standard 标准版 · 480p · 文生 / 首尾帧(5秒 = 44.19 积分)8.838419 积分 / 秒$0.0884 / s$0.123 / s
Standard 标准版 · 720p · 文生 / 首尾帧(5秒 = 95.04 积分)19.007353 积分 / 秒$0.1901 / s$0.265 / s
Standard 标准版 · 1080p · 文生 / 首尾帧(5秒 = 237.59 积分)47.518382 积分 / 秒$0.4752 / s$0.662 / s
Standard 标准版 · 4K(传 "4k")· 文生 / 首尾帧(5秒 = 484.69 积分)96.937500 积分 / 秒$0.9694 / s$1.350 / s