GetRouter文件
  • 繁體中文

    • 影片

    影片生成採非同步處理。請建立任務、儲存其 ID、輪詢任務狀態，並在完成後下載結果。

    一般影片端點如下：

    POST /v1/videos
GET  /v1/videos/{task_id}
GET  /v1/videos/{task_id}/content

    建立影片任務

    /v1/videos 端點接受 multipart 表單資料：

    curl https://getrouter.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=MODEL_ID" \
  -F "prompt=一架紙飛機飛過安靜的現代辦公室" \
  -F "seconds=8"

    對於圖片轉影片輸入，如果模型支援，請加入參考檔案：

    curl https://getrouter.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=MODEL_ID" \
  -F "prompt=加入緩慢推進的鏡頭與細微動態" \
  -F "seconds=8" \
  -F "[email protected]"

    成功的回應會包含 id 等工作識別碼，以及可用的工作中繼資料，例如狀態、進度、模型、長度或時間戳記。

    檢查工作狀態

    curl https://getrouter.ai/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

    請以合理的間隔輪詢。工作進入最終成功或失敗狀態後，請停止輪詢。

    下載結果

    工作完成後：

    curl -L https://getrouter.ai/v1/videos/TASK_ID/content \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --output result.mp4

    建議的工作流程

    1. 提交前驗證模型、長度與輸入。
    2. 只提交工作一次。
    3. 持久儲存傳回的工作 ID。
    4. 使用退避輪詢，而非快速重複傳送請求。
    5. 記錄最終錯誤以供疑難排解。
    6. 盡快下載已完成的內容。
    Warning

    狀態請求逾時時，請勿自動建立替代工作。請先查詢原始工作 ID，以免重複生成及重複收費。

    供應商專屬影片 API

    API 規格也包含供應商相容的影片路徑，包括 Kling 風格及其他工作格式。這些端點的請求欄位與狀態回應各不相同。除非模型或既有用戶端需要供應商專屬路徑，否則新的整合請使用一般 /v1/videos 流程。

    目前提供的路徑與結構描述請參閱 API 參考。

    成本控制

    影片成本可能取決於模型、長度、解析度、品質或輸入類型。請查看 Pricing，並先從短片測試工作開始，再執行自動化批次。

    後續步驟