轮询视频生成任务
返回当前任务状态。当 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
}
}