Video API

统一的视频生成 API，兼容 OpenRouter Video Generation 标准。一套 schema 覆盖文生视频、图生视频、首尾帧与参考图生视频。异步提交任务，再轮询或在完成时接收 webhook。

特性	说明
Base URL	`https://api.ofox.ai`
协议风格	OpenRouter-compatible（异步 submit → poll / webhook）
生成模式	隐式判定：无图 = 文生视频 · `frame_images` = 图生 / 首尾帧 · `input_references` = 参考图生视频
结果送达	轮询 `GET`（含限流保护）或 `callback_url` webhook（HMAC 签名、自动重试）
视频存储	上游原始 URL（临时）+ 可选 CDN 镜像（持久签名 URL）

鉴权

每个请求都在 HTTP header 中携带 ofox API Key（格式 sk-xxx…）：


Authorization: Bearer $OFOX_API_KEY

callback_url 必须为 HTTPS。webhook 回调地址会经 SSRF 校验——私网、环回、云元数据地址一律拒绝。非 HTTPS 或指向内网的地址会在创建时返回 400 invalid_callback_url。

快速开始

1. 提交任务

Terminal


curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo-3.1",
    "prompt": "A golden retriever running on the beach at sunset",
    "duration": 5,
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

调用立即返回 202，附带轮询地址：


{
  "id": "9bcf3c60-7db2-4e1a-a1b2-c3d4e5f60718",
  "status": "pending",
  "polling_url": "https://api.ofox.ai/v1/videos/9bcf3c60-7db2-4e1a-a1b2-c3d4e5f60718"
}

2. 轮询直到 completed

Terminal


curl https://api.ofox.ai/v1/videos/9bcf3c60-7db2-4e1a-a1b2-c3d4e5f60718 \
  -H "Authorization: Bearer $OFOX_API_KEY"

持续请求直到 status 进入终态——completed、failed、cancelled 或 expired。轮询间隔不要快于每秒一次；也可以在创建任务时传入 callback_url，用 webhook 替代轮询。详见查询任务状态与 Webhook 通知。

端点

方法	端点	说明
`POST`	`/v1/videos`	创建视频任务
`GET`	`/v1/videos/{id}`	查询任务状态与结果
`DELETE`	`/v1/videos/{id}`	取消任务

按秒计价

视频模型按时长计费，不使用 token 单价。系统根据分辨率、输入类型与音频选项匹配 pricing.video_pricing.tiers 中的档位，得到美元/秒单价；pricing.output_video_per_second 只表示该模型的最低起价。预估费用可按 档位单价 × 请求时长 计算；任务完成后，以响应中的 usage.video_seconds 与 usage.video_cost 作为最终计费秒数和实际费用。视频转视频任务的计费秒数可能包含输入视频时长。

下一步

创建视频任务查询任务状态取消视频任务 Webhook 通知错误码