ZeroFA API

火山引擎 · 视频生成（Seedance 2.0）

Seedance 2.0 文生视频、图生视频和首尾帧接口。提交异步任务获得 task id，再轮询结果；提交不扣费，成功后按时长计费。

POSThttps://zerofa.ai/v1/videos

可用模型

Seedance 2.0 视频模型
seedance-2-0-lol文生视频可选
Seedance 2.0，最高画质版本。
seedance-2-0-fast-lol文生视频可选
Seedance 2.0 Fast，更快更省，推荐默认使用。
seedance-2-0-mini-lol文生视频可选
Seedance 2.0 Mini，价格更低，适合成本敏感场景。

视频模型见 模型广场 并筛选视频类型。费用按实际时长乘以模型单价计算。

两步式异步流程

  1. 提交：POST /v1/videos 立即返回 id 和 submitted 状态，此时不扣费。
  2. 轮询：每隔几秒请求 GET /v1/videos/{id}，直到 succeeded 或 failed。Seedance 生成 5 秒视频通常需要约 1–2 分钟。
首次成功时按视频时长和模型单价幂等扣费，重复轮询不会重复扣款；失败或超时不扣费。

提交参数

Body 参数application/json
modelstring必填
Seedance 模型，可在上方查看可用模型。
示例：seedance-2-0-fast-lol
promptstring必填
画面描述，并支持中文。
示例：一只橘猫在草地上奔跑，阳光，电影质感
durationinteger可选
时长（秒）。支持值由模型决定，Seedance 常见为 5 或 10 秒。
示例：5
resolutionstring可选
输出分辨率，例如 720P 或 1080P。
示例：720P
aspect_ratiostring可选
画面比例，例如 16:9、9:16 或 1:1。
示例：16:9
negative_promptstring可选
可选的反向提示词。
示例：模糊,畸变
seedinteger可选
随机种子，-1 表示随机。
示例：-1

火山特性

  • 返回火山 TOS 的临时 MP4 链接，通常约 24 小时过期，请及时下载。
  • 仅成功任务按时长计费，例如 5 秒视频按 5 × 每秒单价计算。
  • 支持文生视频、图生视频和首尾帧补间。

图生视频 / 首尾帧

在提交体中加入图片 URL 或 base64 data URI 即可使用图生视频，无需上传文件。

额外 Body 参数（图生视频）
imagestring | string[]可选
参考图。单图作为首帧生成视频，多图作为参考素材合成。
示例：https://...png
first_framestring可选
首帧关键帧，可配合 last_frame 生成首尾帧补间。
示例：https://...png
last_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": "seedance-2-0-fast-lol",
    "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://...mp4
reference_audiostring | string[]可选
参考音频最多 3 段，不能单独使用，必须同时提供至少一张图片或一段视频。
示例：https://...mp3
Seedance 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": "seedance-2-0-lol",
    "prompt": "参考这段视频的运镜，主角换成沙滩奔跑的狗",
    "image": ["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": "seedance-2-0-fast-lol",
    "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}