ZeroFA API

视频生成（异步）

提交生成任务后轮询获取结果。提交时不扣费，任务成功后才按上游实际时长计费，失败不扣费。

POSThttps://zerofa.ai/v1/videos

两步式异步流程

  1. 提交：POST /v1/videos 立即返回 id 和 submitted 状态，此时不扣费。
  2. 轮询：每隔几秒请求 GET /v1/videos/{id}，直到状态变为 succeeded 或 failed。
首次获取成功结果时，系统按上游实际时长和单价扣费。扣费是幂等的，重复轮询不会重复扣款；失败或超时不扣费。视频 URL 通常为约 24 小时有效的临时链接，请及时下载。

提交参数

Body 参数application/json
modelstring必填
视频模型，可在下方查看可用模型。
示例：seedance-2-0-fast-lol
promptstring必填
需要生成的画面描述。
示例：一只柴犬在草地上奔跑，电影质感
durationinteger可选
视频时长（秒），支持范围由具体模型决定。
示例：5
resolutionstring可选
输出分辨率，例如 720P 或 1080P。
示例：720P
aspect_ratiostring可选
画面比例，例如 16:9、9:16 或 1:1。
示例：16:9
enable_audioboolean可选
是否生成音频。默认开启——不传即按 true 处理，传 false 才关闭。兼容别名 generate_audio（两者都传时以 enable_audio 为准）。实际是否有声还取决于所选模型是否支持音频生成。
示例：true

查询任务

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",
    "enable_audio": true
  }'
# → {"id":"<task-id>","status":"submitted"}
② 轮询
curl https://zerofa.ai/v1/videos/<task-id> \
  -H "Authorization: Bearer sk-zerofa-xxx"

# running   → {"id":"...","status":"running","progress":40}
# succeeded → {"id":"...","status":"succeeded",
#              "urls":["https://..."],"duration_sec":5}