获取 Grok 视频任务状态
curl --request GET \
--url https://api.getinfinityblue.com/v1/videos/{task_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.getinfinityblue.com/v1/videos/{task_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.getinfinityblue.com/v1/videos/{task_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "video_abc123",
"object": "video",
"model": "grok-imagine-video-720p",
"status": "in_progress",
"progress": 40,
"created_at": 1764347090922,
"seconds": "10"
}Grok Imagine 视频
获取 Grok 视频任务状态
轮询 Grok 视频任务,获取进度和最终视频 URL
GET
/
v1
/
videos
/
{task_id}
获取 Grok 视频任务状态
curl --request GET \
--url https://api.getinfinityblue.com/v1/videos/{task_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.getinfinityblue.com/v1/videos/{task_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.getinfinityblue.com/v1/videos/{task_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "video_abc123",
"object": "video",
"model": "grok-imagine-video-720p",
"status": "in_progress",
"progress": 40,
"created_at": 1764347090922,
"seconds": "10"
}任务状态说明
| 状态 | 含义 |
|---|---|
queued | 排队等待处理 |
in_progress | 生成中,progress 字段反映百分比进度 |
completed | 已完成,视频 URL 位于 metadata.url |
failed | 生成失败,查看 error 字段了解原因 |
轮询建议
Grok 视频任务通常在数十秒到数分钟内完成,具体取决于分辨率与时长 (720p 比 480p 更慢)。建议每 5–10 秒轮询一次,并设置合理超时时间。获取视频
完成后有两种方式获取视频:- 直接使用
metadata.url中的链接(有效期见expires_at,请尽快下载) - 调用
GET /v1/videos/{task_id}/content通过接口代理下载
授权
路径参数
视频任务 ID,由创建接口返回的 id 字段。
响应
成功获取视频任务状态
Grok 视频任务对象,兼容 OpenAI / Sora 视频任务格式。
视频任务 ID。
示例:
"video_abc123"
对象类型,固定为 video。
可用选项:
video 示例:
"video"
执行任务所用的模型。
可用选项:
grok-imagine-video-480p, grok-imagine-video-720p, grok-imagine-video-1.5-preview-480p, grok-imagine-video-1.5-preview-720p 示例:
"grok-imagine-video-720p"
任务状态。
可用选项:
queued, in_progress, completed, failed 示例:
"queued"
任务进度百分比(0–100)。
必填范围:
0 <= x <= 100示例:
0
任务创建时间戳(毫秒)。
示例:
1764347090922
视频时长,单位秒。
示例:
"10"
任务完成时间戳(毫秒),完成后填充。
示例:
1764347170000
任务及视频文件的过期时间戳(毫秒)。
示例:
1764433570000
实际输出尺寸,格式如 1280x720。
实际分辨率由模型名后缀决定,画幅比例由请求的 size 决定。
示例:
"1280x720"
Grok 视频任务错误信息。
Show child attributes
Show child attributes
额外元数据,任务完成后通常包含 url 字段。
Show child attributes
Show child attributes