跳转到主要内容
GET
/
v1
/
video
/
generations
/
{task_id}
获取视频生成任务状态
curl --request GET \
  --url https://api.getinfinityblue.com/v1/video/generations/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "task_id": "abcd1234efgh",
  "status": "in_progress"
}

​
任务状态说明

状态含义
queued排队等待处理
in_progress生成中
completed已完成，可从 url 字段获取视频
failed生成失败，查看 error 字段了解原因

​
轮询建议

任务通常在 30 秒至数分钟内完成，具体取决于模型和时长。 建议每 5–10 秒轮询一次，并设置合理超时时间（如 10 分钟）。

授权

​
Authorization
string
header
必填

使用 Bearer Token 认证，格式：Authorization: Bearer sk-xxxxxx。 在 控制台 获取 API Key。

路径参数

​
task_id
string
必填

任务 ID，由创建接口返回。

响应

成功获取任务状态

通用视频生成任务状态响应。

​
task_id
string

任务 ID。

示例:

"abcd1234efgh"

​
status
enum<string>

任务状态。

可用选项:
queued,
in_progress,
completed,
failed
示例:

"completed"

​
url
string

视频文件 URL，任务 completed 时返回。

示例:

"https://example.com/generated-video.mp4"

​
format
string

视频格式。

示例:

"mp4"

​
metadata
object

视频生成任务元数据，包含实际生成的视频规格信息。

​
error
object

视频任务错误信息。