创建 Grok 视频任务

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": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

POST

videos

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": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

可用模型

模型 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 秒。

授权

Authorization

string

header

必填

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

请求体

application/json

Grok Imagine 视频生成请求。model 与 prompt 为必填字段。分辨率由模型名后缀（-480p / -720p）决定，请勿传 resolution； size 仅决定画幅比例。

model

enum<string>

必填

模型 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"

prompt

string

必填

文本描述提示词，描述视频内容、动作、场景、镜头语言与风格。图生视频时用于描述期望的运动与变化。

示例:

"一枚水晶动力火箭从火星的红色沙丘上升空，电影感镜头，画面稳定"

size

string

画幅尺寸，格式如 1280x720。仅用于确定画幅比例（横屏 16:9 / 竖屏 9:16 等），不决定分辨率（分辨率由模型名后缀决定）。请勿使用 1792x1024 / 1024x1792（不被接受）。

示例:

"1280x720"

seconds

string

推荐使用。视频时长，单位秒，建议传字符串（如 "5"）。允许范围 1–15 秒。不要与 duration 同时传入。

示例:

"5"

duration

number

兼容字段。视频时长，单位秒，允许范围 1–15。新接入推荐使用顶层 seconds，不要与 seconds 同时传入。

必填范围: 1 <= x <= 15

示例:

5

image

string

单张输入图片，URL 或 Base64 Data URI。设置后触发图生视频模式。 grok-imagine-video-1.5-preview 必须提供输入图。与 images 二选一。

示例:

"https://example.com/image.jpg"

input_reference

string

输入图片（Sora 风格字段），URL 或 Base64 Data URI，等价于 image。用于图生视频；与 image 任填其一即可。

示例:

"https://example.com/image.jpg"

images

string[]

多张参考图片，URL 或 Base64。用于参考视频模式（仅 grok-imagine-video 支持）。与 image 互斥。多图参考的推荐字段。

示例:

[
  "https://example.com/reference-1.jpg",
  "https://example.com/reference-2.jpg"
]

ref_images

string[]

参考图片数组的兼容别名，与 images 等价（择一即可，勿与 images 同时传）。供沿用此约定的客户端使用；新接入推荐使用 images。

示例:

[
  "https://example.com/reference-1.jpg",
  "https://example.com/reference-2.jpg"
]

user

string

终端用户标识，用于业务侧审计和风控，不参与生成。

示例:

"user-1234"

响应

成功创建 Grok 视频任务

Grok 视频任务对象，兼容 OpenAI / Sora 视频任务格式。

string

必填

视频任务 ID。

示例:

"video_abc123"

object

enum<string>

必填

对象类型，固定为 video。

可用选项:

video

示例:

"video"

model

enum<string>

必填

执行任务所用的模型。

可用选项:

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"

status

enum<string>

必填

任务状态。

可用选项:

queued,

in_progress,

completed,

failed

示例:

"queued"

progress

integer

必填

任务进度百分比（0–100）。

必填范围: 0 <= x <= 100

示例:

0

created_at

integer<int64>

必填

任务创建时间戳（毫秒）。

示例:

1764347090922

seconds

string

必填

视频时长，单位秒。

示例:

"10"

completed_at

integer<int64>

任务完成时间戳（毫秒），完成后填充。

示例:

1764347170000

expires_at

integer<int64>

任务及视频文件的过期时间戳（毫秒）。

示例:

1764433570000

size

string

实际输出尺寸，格式如 1280x720。实际分辨率由模型名后缀决定，画幅比例由请求的 size 决定。

示例:

"1280x720"

error

object

Grok 视频任务错误信息。

Show child attributes

metadata

object

额外元数据，任务完成后通常包含 url 字段。

Show child attributes

开始使用

模型（Models）

聊天（Chat）

图像（Images）

视频（Videos）

指南

可用模型

关键：分辨率由模型名决定

size 仅决定画幅比例

调用流程

图生视频与参考视频

时长

授权

请求体

响应

​可用模型

​关键：分辨率由模型名决定

​size 仅决定画幅比例

​调用流程

​图生视频与参考视频

​时长

授权

请求体

响应

可用模型

关键：分辨率由模型名决定

size 仅决定画幅比例

调用流程

图生视频与参考视频

时长