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-video | Fast 极速版文生视频(480p / 720p · 比标准版省 39%) | prompt |
| seedance-2.0-fast-image-to-video | Fast 极速版首尾帧图生视频(480p / 720p) | prompt + image_urls (1..2) |
| seedance-2.0-text-to-video | Standard 标准版文生视频(最高支持 4K) | prompt |
| seedance-2.0-image-to-video | Standard 标准版首尾帧图生视频(最高支持 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 |