Seedance 2.5 Flash 接口文档
高速长镜头文生与首尾帧视频模型,支持 4–30 秒 480p/720p 输出与原生音画同步,720p 单价更低且出片更快。
POST /v1/videos/generations
公开模型 ID 与生成模式
面向高频分镜预演与快速出片的 Seedance 2.5 高速版,支持 4–30 秒 480p(14.10 积分/秒)与 720p(28.20 积分/秒)生成。
纯文生视频传入 *-text-to-video 模型 ID;图生视频传入 *-image-to-video 并在 image_urls 中传入 1 张首帧或 2 张首尾帧 HTTPS 图片链接。文生与图生每秒单价一致,内置原生音画同步无附加费。
| 公开 Model ID | 生成模式 | 必填字段 |
|---|---|---|
| seedance-2.5-flash-text-to-video | 文生视频(4–30 秒) | prompt |
| seedance-2.5-flash-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-flash-text-to-video" | "seedance-2.5-flash-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"默认: "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-flash-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-flash-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.50 积分) | 14.100000 积分 / 秒 | $0.1410 / s | — |
| 720p · 文生或首尾帧图生 · 含音画同步(5秒 = 141.00 积分) | 28.200000 积分 / 秒 | $0.2820 / s | — |