zayuapi.com 视频生成 API 对接文档
视频是异步任务，不是一次请求就返回视频。
调用流程：创建任务 → 轮询状态 → 取成片，共三步。
本站接口兼容标准 Sora 任务形状，new-api / one-api 原生支持。
基础信息
- Base URL：
https://zayuapi.com - 认证方式：
Authorization: Bearer sk-你的密钥 - Content-Type：
application/json - 接口风格：异步任务，创建后立即返回任务 ID，需要轮询直到完成
① 创建任务
创建任务会立即返回 task_id / id，不会等待视频生成完成。
curl https://zayuapi.com/v1/videos \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "videos-mini-480p",
"prompt": "一只橘猫在草地上慢慢走过，阳光透过树叶",
"duration": 4,
"ratio": "16:9"
}'返回示例：
{
"id": "task_abc123",
"status": "queued"
}⚠️ 请记住响应里的id字段，不是task_id字段。
后续轮询和取片都统一使用这个id。
② 轮询任务状态
建议每 10 秒 轮询一次，直到状态为 completed 或 failed。
curl https://zayuapi.com/v1/videos/task_abc123 \
-H "Authorization: Bearer sk-你的密钥"状态说明：
| status | 含义 |
|---|---|
queued / pending | 排队中 |
processing / in_progress | 生成中 |
completed | 成功 |
failed / cancelled | 失败，不扣费 |
出片时间参考：
- 普通 4 秒片：约 2.5 分钟
- 带参考素材或高档位：约 5–15 分钟
wan-3.0的 30 秒长片：可能 20 分钟以上
轮询超时至少留 40 分钟，慢不等于死。
③ 取成片
推荐直接使用 content 接口，会返回 mp4 二进制流，不用管签名过期问题。
curl https://zayuapi.com/v1/videos/task_abc123/content \
-H "Authorization: Bearer sk-你的密钥" \
-o out.mp4响应里的 url / video_url 是带签名的临时直链，约 3 天失效。
拿到 completed 后请立即下载转存到自己的存储，不要热链给最终用户。
本站侧另有 7 天成片存档，过期后 7 天内可联系补发。
偶发情况：刚 completed 时成片还在转存，取片可能返回 502。
处理方式：等 5 秒重试，最多 6 次，这不是失败。
请求字段
| 字段 | 必填 | 说明 |
|---|---|---|
model | 是 | 分辨率编码在模型名里，如 -480p / -720p / -1080p / -4k。选哪档用哪个名字，不要自己改后缀 |
prompt | 通常必填 | 视频提示词 |
duration | 否 | 时长，单位秒。多数模型 4–15；wan-3.0 系可到 30；grok 系 1–15，默认 8。推荐使用 duration |
ratio | 否 | 16:9 / 9:16 / 1:1，也兼容 size: "1280x720" 写法，会自动换算 |
referenceImages | 否 | 参考图 URL 数组 |
referenceVideos | 否 | 参考视频 URL 数组 |
referenceAudios | 否 | 参考音频 URL 数组 |
image | 否 | grok 系专用，单张图，锁首帧 |
reference_images | 否 | grok 系专用，[{"url":"..."}]，≤7 张引导，不锁首帧 |
响应回显的model可能不带分辨率后缀，task_id是内部 ID，都正常。
轮询统一用id字段。
参考素材：图生视频等
| 方式 | 字段 | 说明 |
|---|---|---|
| URL（强烈推荐） | referenceImages / referenceVideos / referenceAudios，字符串数组 | 必须是公网可直接访问的 http(s) URL，不收 base64，且生成期间不能失效。速度和纯文生几乎一样，约 2.5 分钟 |
| 本地文件上传 | 同名字段，multipart/form-data | 能用但慢约 6 倍，可能 14 分钟。上游对上传文件没优化，能给 URL 就给 URL |
| grok 系专用 | image 单张锁首帧，或 reference_images: [{"url":"..."}] ≤7 张引导，不锁首帧 | 两个字段互斥；1080p 档不支持 reference_images |
每个模型收几张图 / 几条视频 / 几条音频，见价格目录 constraints.references。
通用图生视频示例
{
"model": "seedance-2-5-720p",
"prompt": "让画面里的人物转身微笑",
"duration": 8,
"referenceImages": ["https://your-cdn.com/a.jpg"],
"referenceAudios": ["https://your-cdn.com/bgm.mp3"]
}视频计费
- 按秒
per_second：单价 × duration，严格线性。
例：¥0.24/秒 拍 4 秒 = ¥0.96。 - 按条一口价
per_clip：4–15 秒同价，拉满 15 秒最划算。 - 带参考视频加价：
videos-*系 ×1.3，seedance-2-5-*系 ×1.4，系数见价格目录。
只带参考图、参考音频不加价。
例：¥0.75/秒 × 8 秒 = ¥6，带参考视频 = ¥7.8。 - 生成失败自动全额退款，审核不过也不扣。
- ⚠️ 同名前缀计费方式可能不同，例如
videos-standard-720p按秒、sd2-pro按条。
永远以价格目录的billing字段精确匹配，不要按名字猜。
快速调用总结
POST https://zayuapi.com/v1/videos 创建任务，拿 id
GET https://zayuapi.com/v1/videos/{id} 轮询状态
GET https://zayuapi.com/v1/videos/{id}/content 取 mp4 成片认证头：
Authorization: Bearer sk-你的密钥核心原则：
- 创建任务后记住
id，不要用task_id。 - 每 10 秒轮询一次，至少留 40 分钟超时。
- 完成后立即下载转存，临时直链约 3 天失效。
- 取片 502 时等 5 秒重试，最多 6 次。
