查詢影片

使用建立 API 回傳的 Video ID 取得任務狀態、生成進度和結果中繼資料；任務成功或失敗後應停止輪詢。

GET/v1/videos/{video_id}

使用建立 API 回傳的 Video ID 查詢影片任務狀態和結果中繼資料。影片生成是非同步程序；任務仍處於 processing 時，可以稍後再次查詢，並在進入 succeeded 或 failed 後停止輪詢。

應限制輪詢次數並設定總逾時，避免無限或過度頻繁地請求。本頁面不使用平台 Video Generations 的任務路徑和狀態枚舉。

授權

bearerAuth

授權Bearer <token>

在 Authorization Header 中使用 Bearer your-api-key。

傳遞位置: header

video_id*string

建立影片API 回傳的 Video ID。

長度1 <= length

curl -X GET "https://example.com/v1/videos/video_123"

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "created_at": 1640995200,
  "status": "processing",
  "progress": 35
}