curl --request POST \
--url https://api.getinfinityblue.com/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "grok-imagine-video-720p",
"prompt": "一枚水晶动力火箭从火星的红色沙丘上升空，背景的远古遗迹随之亮起，电影感镜头，画面稳定",
"seconds": "10",
"size": "1280x720"
}
'{
"id": "video_abc123",
"object": "video",
"model": "grok-imagine-video-720p",
"status": "queued",
"progress": 0,
"created_at": 1764347090922,
"seconds": "10"
}{
"error": {
"message": "无效的时长。支持的范围为 1 到 15 秒。",
"type": "invalid_request_error",
"param": "seconds",
"code": "invalid_duration"
}
}{
"error": {
"message": "无效的时长。支持的范围为 1 到 15 秒。",
"type": "invalid_request_error",
"param": "seconds",
"code": "invalid_duration"
}
}{
"error": {
"message": "无效的时长。支持的范围为 1 到 15 秒。",
"type": "invalid_request_error",
"param": "seconds",
"code": "invalid_duration"
}
}{
"error": {
"message": "无效的时长。支持的范围为 1 到 15 秒。",
"type": "invalid_request_error",
"param": "seconds",
"code": "invalid_duration"
}
}创建 Grok 视频任务
提交 Grok Imagine 文生/图生/参考视频任务，分辨率由模型名决定
curl --request POST \
--url https://api.getinfinityblue.com/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "grok-imagine-video-720p",
"prompt": "一枚水晶动力火箭从火星的红色沙丘上升空，背景的远古遗迹随之亮起，电影感镜头，画面稳定",
"seconds": "10",
"size": "1280x720"
}
'{
"id": "video_abc123",
"object": "video",
"model": "grok-imagine-video-720p",
"status": "queued",
"progress": 0,
"created_at": 1764347090922,
"seconds": "10"
}{
"error": {
"message": "无效的时长。支持的范围为 1 到 15 秒。",
"type": "invalid_request_error",
"param": "seconds",
"code": "invalid_duration"
}
}{
"error": {
"message": "无效的时长。支持的范围为 1 到 15 秒。",
"type": "invalid_request_error",
"param": "seconds",
"code": "invalid_duration"
}
}{
"error": {
"message": "无效的时长。支持的范围为 1 到 15 秒。",
"type": "invalid_request_error",
"param": "seconds",
"code": "invalid_duration"
}
}{
"error": {
"message": "无效的时长。支持的范围为 1 到 15 秒。",
"type": "invalid_request_error",
"param": "seconds",
"code": "invalid_duration"
}
}可用模型
| 模型 ID | 分辨率 | 能力 |
|---|---|---|
grok-imagine-video-480p | 480p | 文生 / 图生 / 参考视频，自带音频 |
grok-imagine-video-720p | 720p | 文生 / 图生 / 参考视频，自带音频 |
grok-imagine-video-1.5-preview-480p | 480p | 仅图生视频（必须带输入图），自带音频 |
grok-imagine-video-1.5-preview-720p | 720p | 仅图生视频（必须带输入图），自带音频 |
关键：分辨率由模型名决定
Grok 视频按分辨率分档计费，分辨率通过模型名后缀选择： 需要 720p 就调用...-720p，需要 480p 就调用 ...-480p。
不要传入 resolution 参数（不生效）。不同分辨率对应不同单价，
以 模型与价格页 为准。
size 仅决定画幅比例
size（如 1280x720、720x1280）只用来确定画幅比例
（横屏 16:9 / 竖屏 9:16 等），不决定分辨率。
请勿使用 1792x1024 / 1024x1792，这两个尺寸不被接受。
调用流程
POST /v1/videos— 提交任务，获取id（即task_id）GET /v1/videos/{task_id}— 轮询，直到status=completed- 从
metadata.url读取视频 URL，或通过GET /v1/videos/{task_id}/content直接下载视频流
图生视频与参考视频
- 图生视频：传入
image或input_reference（URL 或 Base64 Data URI）， 模型将以该图片为首帧动态化。grok-imagine-video-1.5-preview必须带输入图。 - 参考视频（仅
grok-imagine-video）：传入images数组提供多张参考图， 引导生成内容；image与images二选一。 兼容别名ref_images（根级数组，与images等价、择一即可、勿同时传）也可用， 供沿用此约定的客户端使用；新接入推荐images。
时长
通过seconds（推荐，字符串如 "5"）或 duration（数字）指定，
允许范围 1–15 秒。授权
请求体
Grok Imagine 视频生成请求。model 与 prompt 为必填字段。
分辨率由模型名后缀（-480p / -720p）决定，请勿传 resolution；
size 仅决定画幅比例。
模型 ID。分辨率由后缀决定（-480p / -720p），并按分辨率分档计费。
grok-imagine-video 支持文生/图生/参考视频；
grok-imagine-video-1.5-preview 仅支持图生视频（必须带输入图）。
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"
文本描述提示词，描述视频内容、动作、场景、镜头语言与风格。 图生视频时用于描述期望的运动与变化。
"一枚水晶动力火箭从火星的红色沙丘上升空，电影感镜头，画面稳定"
画幅尺寸，格式如 1280x720。仅用于确定画幅比例
（横屏 16:9 / 竖屏 9:16 等），不决定分辨率（分辨率由模型名后缀决定）。
请勿使用 1792x1024 / 1024x1792（不被接受）。
"1280x720"
推荐使用。视频时长，单位秒，建议传字符串（如 "5"）。
允许范围 1–15 秒。不要与 duration 同时传入。
"5"
兼容字段。视频时长，单位秒，允许范围 1–15。
新接入推荐使用顶层 seconds，不要与 seconds 同时传入。
1 <= x <= 155
单张输入图片，URL 或 Base64 Data URI。设置后触发图生视频模式。
grok-imagine-video-1.5-preview 必须提供输入图。与 images 二选一。
"https://example.com/image.jpg"
输入图片（Sora 风格字段），URL 或 Base64 Data URI，等价于 image。
用于图生视频；与 image 任填其一即可。
"https://example.com/image.jpg"
多张参考图片，URL 或 Base64。用于参考视频模式
（仅 grok-imagine-video 支持）。与 image 互斥。多图参考的推荐字段。
[
"https://example.com/reference-1.jpg",
"https://example.com/reference-2.jpg"
]
参考图片数组的兼容别名，与 images 等价（择一即可，勿与 images 同时传）。
供沿用此约定的客户端使用；新接入推荐使用 images。
[
"https://example.com/reference-1.jpg",
"https://example.com/reference-2.jpg"
]
终端用户标识，用于业务侧审计和风控，不参与生成。
"user-1234"
响应
成功创建 Grok 视频任务
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 <= 1000
任务创建时间戳（毫秒）。
1764347090922
视频时长，单位秒。
"10"
任务完成时间戳（毫秒），完成后填充。
1764347170000
任务及视频文件的过期时间戳（毫秒）。
1764433570000
实际输出尺寸，格式如 1280x720。
实际分辨率由模型名后缀决定，画幅比例由请求的 size 决定。
"1280x720"
Grok 视频任务错误信息。
Show child attributes
Show child attributes
额外元数据，任务完成后通常包含 url 字段。
Show child attributes
Show child attributes