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 通知錯誤碼