Seedance 2.5 接口文档

旗舰电影级文生与首尾帧图生视频模型,支持 4–30 秒与最高 1080p 输出,内置原生音画同步,按 0.1 秒实际时长计费。

POST /v1/videos/generations

公开模型 ID 与生成模式

旗舰级电影感视频生成家族,支持 4–30 秒长镜头与 480p、720p、1080p 三档分辨率。

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

公开 Model ID生成模式必填字段
seedance-2.5-text-to-video文生视频(4–30 秒)prompt
seedance-2.5-image-to-video首尾帧图生视频(4–30 秒)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.5-text-to-video" | "seedance-2.5-image-to-video"
选择文生视频(text-to-video)或首尾帧图生视频(image-to-video)公开 ID。
prompt
必填
string
非空 UTF-8 镜头画面、动作与音频描述提示词。
image_urls
可选
string[] (1..2)默认: required on I2V
图生视频模式必填 1 张首帧或 2 张首尾帧 HTTPS 图片链接(不加收参考图费)。
quality
可选
"480p" | "720p" | "1080p"默认: "720p"
输出视频清晰度档位,决定每秒积分单价。
duration
可选
integer (4..30s)默认: 5
请求时长(4..30s)。最低 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.5-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.5-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 积分折合美元官方参考价
480p · 文生或首尾帧图生 · 含音画同步(5秒 = 70.31 积分)14.061121 积分 / 秒$0.1406 / s—
720p · 文生或首尾帧图生 · 含音画同步(5秒 = 151.19 积分)30.238971 积分 / 秒$0.3024 / s—
1080p · 文生或首尾帧图生 · 含音画同步(5秒 = 377.99 积分)75.597426 积分 / 秒$0.7560 / s—