OpenRouter 视频生成 API 2026 完整指南
2026 年 8 月 25 日,OpenRouter 上线了一个统一的异步端点 POST /api/v1/videos,将 26 个视频生成模型集中托管——覆盖字节跳动的 Seedance、谷歌的 Veo、OpenAI 的 Sora 2、阿里云的 Wan、Runway、Kling、HeyGen、Black Forest Labs 的 FLUX 以及 MiniMax 的 Hailuo。在此之前,要给应用添加视频生成能力意味着每个供应商都要接一套独立的 SDK,每套都有自己的认证、请求格式、任务状态、轮询节奏和下载 URL。OpenRouter 的做法把这一切压缩成了一个工作流:提交任务 → 轮询 polling_url → 拉取完成的 MP4。
本文基于 OpenRouter 官方 2026 年 8 月 25 日发布指南、当日抓取的 /api/v1/videos/models 在线目录(26 个模型)以及各模型返回的 pricing_skus 价格表。
为什么是异步 API,而不是普通的阻塞调用
典型的文本补全 API 在 200-800 毫秒内返回。典型的图像生成 API 在 1-4 秒内返回。视频生成是第一个生成时间经常超过单次 HTTP 请求超时容忍度的 API 类别。OpenRouter 的指南将 30 秒到几分钟的生成时长列为常见情况。Serverless 平台(Cloudflare Workers、AWS Lambda)的执行时长上限是 30 秒到 15 分钟;企业代理和负载均衡器在 60-300 秒后闲置超时;移动网络在 30-60 秒无响应后断开。
异步模式是教科书级别的修复方案:把提交和完成分开。
价格:$0.03/秒 到 $0.60/秒
| 模型 | 计费模式 | 720p/1080p 价格 | 4K 档 | 支持音频 |
|---|---|---|---|---|
| Veo 3.1 | $0.20/秒(无音频)/ $0.40/秒(音频) | $0.20-0.40/秒 | $0.40-0.60/秒 | ✅ |
| Veo 3.1 Fast | $0.10/秒(无音频)/ $0.12/秒(音频) | $0.08-0.10/秒 | $0.25-0.30/秒 | ✅ |
| Veo 3.1 Lite | $0.05/秒(无音频)/ $0.08/秒(音频) | $0.03-0.05/秒 | — | ✅ |
| Sora 2 Pro | $0.30-0.50/秒 | $0.30(720p)/ $0.50(1080p) | — | ❌ |
| Seedance 2.5 | video_tokens: $0.0000107/token | ~$0.18/秒 | — | ✅ |
| Seedance 2.0 | video_tokens: $0.000007/token | ~$0.13/秒 | $0.000004/token | ✅ |
| Seedance 2.0 Fast | video_tokens: $0.0000042/token | ~$0.08/秒 | — | ✅ |
| Seedance 2.0 Mini | video_tokens: $0.0000035/token | ~$0.07/秒 | — | ✅ |
| Wan 3.0 | $0.05-0.10/秒 | $0.10(720p)/ $0.20(1080p) | — | ✅ |
| Wan 2.7 | $0.10/秒 | $0.10/秒 | — | ❌ |
| Wan 2.6 | $0.04-0.08/秒 | $0.08(720p)/ $0.12(1080p) | — | ❌ |
| Kling v3.0 Pro | $0.112/秒(+$0.056 音频) | $0.112/秒 | $0.112(1080p) | ✅ |
| Runway Gen-4.5 | $0.12/秒 | $0.12/秒 | — | ❌ |
| Runway Aleph 2.0 | $0.28/秒,最低 $0.56 | $0.28/秒 | — | ❌ |
| MiniMax H3 | $0.13/秒 + $0.04/参考图 | $0.13/秒 | — | ❌ |
| HeyGen Avatar IV | $0.05/秒 | $0.05/秒 | — | ❌ |
来源:https://openrouter.ai/api/v1/videos/models,抓取时间 2026 年 8 月 26 日。
Veo 3.1 Lite $0.03-0.05/秒是带音频的最便宜 720p 模型,Wan 2.6 $0.04-0.08/秒是不带音频的最便宜 720p 模型。一段带音频的 5 秒 1080p 视频片段价格从 $0.40(Wan 2.6) 到 $3.00(Veo 3.1 4K 音频)。
已验证的端点行为
提交任务
唯一的提交端点是 POST https://openrouter.ai/api/v1/videos。成功提交返回 HTTP 202 Accepted 以及任务封装:
{
"id": "job-abc123",
"status": "pending",
"polling_url": "https://openrouter.ai/api/v1/videos/job-abc123"
}
轮询任务
polling_url 与 GET https://openrouter.ai/api/v1/videos/{id} 相同。任务会经历:pending → in_progress → completed / failed / cancelled / expired。推荐轮询间隔 30 秒。
下载完成的视频
当 status: "completed" 到达时,响应包含一个填充好的 unsigned_urls 数组,需要 Authorization: Bearer 请求头:
curl "https://openrouter.ai/api/v1/videos/job-abc123/content?index=0" \
-H "Authorization: Bearer *** \
--output out.mp4
一行切换模型
MODEL = "bytedance/seedance-2.0" # 或 "google/veo-3.1" 或 "alibaba/wan-2.7"
job = submit_video(model=MODEL, prompt=PROMPT)
completed_job = poll_video(job)
download_video(completed_job)
已验证的限制
- **零数据保留(ZDR)不支持**视频生成。
- **音频能力差异巨大**。26 个模型中只有 9 个支持 `generate_audio: true`。
- **分辨率支持差异巨大**。有些仅支持 720p,有些支持 480p/720p/1080p,只有 Veo 3.1 支持 4k。
- **`unsigned_urls` 是误导性名称**。这些 URL 不是预签名的。
总结
OpenRouter 的视频 API 是首个覆盖生产视频生成现实价格/质量跨度的单端点抽象。26 个模型足以对预算与旗舰输出进行 A/B 测试。
昂贵的模型只值得用于核心内容。Veo 3.1 $0.40/秒 是产品发布预告片的正确选择;但对于批量 UGC 渲染,Wan 2.6 $0.04-0.08/秒 在相同预算下可产出 5-10 倍数量的相当 720p 输出。
零数据保留是合规工作负载的拦路虎。如果你的合规姿态要求 ZDR,通过 OpenRouter 进行视频生成今天还不是一个选项。
常见问题
OpenRouter 视频生成成本是多少?
每秒价格从 $0.03(Veo 3.1 Lite,无音频)到 $0.60(Veo 3.1 4K 带音频)不等。带音频的 5 秒 1080p 视频片段价格在 $0.40 到 $3.00 之间。
如何在不重写代码的情况下切换视频模型?
修改提交体中的 model 字段。端点、认证、响应形状、状态处理和下载 URL 在所有 26 个支持的模型中是相同的。
AI 视频生成需要多长时间?
通常 30 秒到几分钟,取决于模型、分辨率和片段长度。
视频生成是否符合零数据保留?
不符合。异步检索步骤要求生成的输出被短暂保留以便下载,因此强制 ZDR 的账户不会被路由到视频生成。
我可以使用 Webhook 而不是轮询吗?
可以。在提交体中传递 callback_url,OpenRouter 将在任务达到终态时 POST 到该 URL。
我应该为批量 UGC 选择哪个模型?
Wan 2.6 $0.04-0.08/秒(无音频)是最便宜的 720p 选项。
来源
- [OpenRouter 视频生成 API:代码优先指南](https://openrouter.ai/blog/tutorials/video-generation-api)(2026 年 8 月 25 日)
- [OpenRouter 视频模型目录](https://openrouter.ai/api/v1/videos/models)(2026 年 8 月 26 日快照)
- [OpenRouter 文档快速入门](https://openrouter.ai/docs/quickstart)
- [OpenRouter 价格页](https://openrouter.ai/pricing)
- [OpenRouter 联盟](https://openrouter.ai/affiliates)
- [OpenRouter 首页](https://openrouter.ai/)