取得影片生成工作
get/v1/video/generations/{task_id}
取得影片生成工作的狀態與結果。
工作狀態：
queued：在佇列中等待in_progress：生成中completed：已完成failed：失敗
驗證
把 OLETOKEN 的 API Key 作為 Bearer Token 放進 Authorization 請求標頭。金鑰在控制台的「API 金鑰」頁建立。
Authorization: Bearer $OLETOKEN_API_KEY請求參數
| 欄位 | 類型 | 必填 | 說明 |
|---|---|---|---|
| task_idpath | string | 工作 ID |
回應
200已取得工作狀態
| 欄位 | 類型 | 必填 | 說明 |
|---|---|---|---|
| task_id | string | — | 工作 ID |
| status | stringqueuedin_progresscompletedfailed | — | 工作狀態 |
| url | string | — | 影片 URL（工作成功時） |
| format | string | — | 影片格式 |
| metadata | VideoTaskMetadata | — | — |
| duration | number | — | 實際影片長度 |
| fps | integer | — | 實際影格率 |
| width | integer | — | 實際寬度 |
| height | integer | — | 實際高度 |
| seed | integer | — | 實際使用的隨機種子 |
| error | VideoTaskError | — | — |
| code | integer | — | 錯誤代碼 |
| message | string | — | 錯誤訊息 |
404找不到工作
| 欄位 | 類型 | 必填 | 說明 |
|---|---|---|---|
| error | object | — | — |
| message | string | — | 錯誤訊息 |
| type | string | — | 錯誤類型 |
| param | string | null | — | 相關的參數 |
| code | string | null | — | 錯誤代碼 |
請求範例
curl -X GET 'https://api.oletoken.ai/v1/video/generations/{task_id}' \
-H "Authorization: Bearer $OLETOKEN_API_KEY"