可用模型
加载中…
视频模型见 模型广场 并筛选视频类型。费用按实际时长乘以模型单价计算。
两步式异步流程
- 提交：POST /v1/videos 立即返回 id 和 submitted 状态，此时不扣费。
- 轮询：每隔几秒请求 GET /v1/videos/{id}，直到 succeeded 或 failed。Seedance 生成 5 秒视频通常需要约 1–2 分钟。
首次成功时按视频时长和模型单价幂等扣费，重复轮询不会重复扣款；失败或超时不扣费。
提交参数
Body 参数application/json
modelstring必填Seedance 模型，可在上方查看可用模型。
示例：
your-seedance-model-idpromptstring必填画面描述，并支持中文。
示例：
一只橘猫在草地上奔跑，阳光，电影质感durationinteger可选时长（秒）。支持值由模型决定，Seedance 常见为 5 或 10 秒。
示例：
5resolutionstring可选输出分辨率，例如 720P 或 1080P。
示例：
720Paspect_ratiostring可选画面比例，例如 16:9、9:16 或 1:1。
示例：
16:9negative_promptstring可选可选的反向提示词。
示例：
模糊,畸变seedinteger可选随机种子，-1 表示随机。
示例：
-1火山特性
- 返回火山 TOS 的临时 MP4 链接，通常约 24 小时过期，请及时下载。
- 仅成功任务按时长计费，例如 5 秒视频按 5 × 每秒单价计算。
- 支持文生视频、图生视频和首尾帧补间。
图生视频 / 首尾帧
在提交体中加入图片 URL 或 base64 data URI 即可使用图生视频，无需上传文件。
额外 Body 参数（图生视频）
imagestring | string[]可选参考图。单图作为首帧生成视频，多图作为参考素材合成。
示例：
https://...pngimagesstring[]可选多张参考图，按数组顺序编号为图片1、图片2……；支持公网 URL 或 data URI。
示例：
["https://.../person.png","https://.../scene.png"]first_framestring可选首帧关键帧，可配合 last_frame 生成首尾帧补间。
示例：
https://...pnglast_framestring可选末帧关键帧。
示例：
https://...png图生视频 · curl
# 图生视频：通过 image 传入图片 URL（或 base64 data URI），让图片动起来
curl https://zerofa.ai/v1/videos \
-H "Authorization: Bearer sk-zerofa-xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "your-seedance-model-id",
"prompt": "猫站起来伸懒腰，镜头缓慢推近",
"image": "https://your-cdn.com/cat.png",
"duration": 5
}'
# 首尾帧补间：传入首帧和末帧，自动生成中间画面
# "first_frame": "https://.../a.png",
# "last_frame": "https://.../b.png"多模态参考（r2v）· Seedance 2.0
Seedance 2.0 支持混合参考图片、视频和音频，可借鉴运镜风格或添加配乐与口型参考。
额外 Body 参数（多模态参考）
reference_videostring | string[]可选参考视频 URL 或 data URI，最多 3 段，用于参考运动和风格。
示例：
https://...mp4reference_audiostring | string[]可选参考音频最多 3 段，不能单独使用，必须同时提供至少一张图片或一段视频。
示例：
https://...mp3Seedance 2.0 多模态上限为图片 9 张、视频 3 段、音频 3 段，最长 15 秒。
多模态参考 · curl
# 多模态参考（Seedance 2.0）：同时参考图片、视频和音频
curl https://zerofa.ai/v1/videos \
-H "Authorization: Bearer sk-zerofa-xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "your-seedance-model-id",
"prompt": "参考这段视频的运镜，主角换成沙滩奔跑的狗",
"images": ["https://.../dog.png"],
"reference_video": ["https://.../style.mp4"],
"reference_audio": ["https://.../bgm.mp3"],
"duration": 5
}'查询任务
GET
/v1/videos/{id}返回 submitted、running、succeeded 或 failed 状态。成功时包含 urls 和 duration_sec。终态结果会缓存，重复查询不会再次请求上游。
请求与响应体
用下面的示例确认请求格式与返回结构。需要在线发起请求时，点击页面顶部“调试”拉起在线运行面板。
① 提交
curl https://zerofa.ai/v1/videos \
-H "Authorization: Bearer sk-zerofa-xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "your-seedance-model-id",
"prompt": "一只橘猫在草地上奔跑，阳光，电影质感",
"duration": 5,
"resolution": "720P",
"aspect_ratio": "16:9"
}'
# → {"id":"<task-id>","status":"submitted"}② 轮询
curl https://zerofa.ai/v1/videos/<task-id> \
-H "Authorization: Bearer sk-zerofa-xxx"
# running → {"id":"...","status":"running"}
# succeeded → {"id":"...","status":"succeeded",
# "urls":["https://...volces.com/....mp4?..."],
# "duration_sec":5}