輪詢影片生成任務
傳回目前的任務狀態。當 status 為 succeeded 時,outputs 會包含可匿名下載的已簽章媒體 URL(https://openapi.felo.ai/api/v1/media/{file_id}?exp=...&sig=...)。請以 5-10 秒的間隔輪詢;任務本身會在背景繼續執行。
路徑參數
- 類型: stringtask
_id 必填由 POST /api/v1/videos/generations 傳回的任務 ID。
回應
- 類型: object · VideoGenerationTask200
目前的任務狀態
- 列舉kind常數:video必填值
- video
- 類型: array string[] 格式: urioutputs必填
- 類型: string 列舉status必填值
- queued
- running
- succeeded
- failed
- interrupted
- 類型: stringtask
_id 必填 - 類型: objecterror
任務失敗時才會出現。
- code類型: string
Stable failure code, e.g. file_not_found.
- message類型: string
- param類型: string | null
- type類型: string
application/json - 類型: object · GenerationError401
Felo API 金鑰無效或未提供
相容於 OpenAI 的錯誤封裝。
- 類型: objecterror
- message類型: string必填
- type類型: string 列舉必填值
- invalid
_request _error - server
_error
- code類型: string
- param類型: string 可為 null
application/json - 類型: object · GenerationError404
此帳戶找不到該任務
相容於 OpenAI 的錯誤封裝。
- 類型: objecterror
- message類型: string必填
- type類型: string 列舉必填值
- invalid
_request _error - server
_error
- code類型: string
- param類型: string 可為 null
application/json - 類型: object · GenerationError503
生成服務暫時無法使用
相容於 OpenAI 的錯誤封裝。
- 類型: objecterror
- message類型: string必填
- type類型: string 列舉必填值
- invalid
_request _error - server
_error
- code類型: string
- param類型: string 可為 null
application/json
Request Example for get/api/v1/videos/generations/{task_id}
curl 'https://openapi.felo.ai/api/v1/videos/generations/{task_id}' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"task_id": "string",
"status": "queued",
"kind": "video",
"outputs": [
"https://example.com"
],
"error": {
"message": "string",
"type": "string",
"code": "string",
"param": null
}
}