動画生成タスクをポーリング
現在のタスクステータスを返します。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
}
}