Grok Imagine 1.0 视频生成

xAI Grok Imagine 1.0 视频系列。与 Grok Video 3 系列不同，本系列时长由 video_config.video_length 控制。

接入地址

线路	Base URL	说明
国内加速（推荐）	`https://cdn.wusag.com`	走国内 CDN 节点
海外直连	`https://api.xinliu.one`	海外服务器或加速节点异常时使用

两个地址共用同一账户和 Key。

请求

方法：POST {Base URL}/v1/videos

Header：

Authorization: Bearer 你的令牌

Content-Type: application/json 或 multipart/form-data

可用模型

model	时长
`grok-imagine-1.0-video`	6 / 10 / 15 秒（由 `video_config.video_length` 控制）
`grok-imagine-1.0-video-20s`	20 秒固定
`grok-imagine-1.0-video-30s`	30 秒固定

横竖版通过 aspect_ratio 参数控制，不通过模型名。

参数（JSON 方式）

字段	类型	必填	说明
`model`	string	是	见上表
`prompt`	string	是	提示词
`reference_images`	array	否	图生视频参考图，最多 7 张
`video_config.video_length`	int	否	时长 6 / 10 / 15（仅基础 `grok-imagine-1.0-video` 可调）
`video_config.aspect_ratio`	string	否	`16:9` / `9:16` / `1:1` / `2:3` / `3:2`
`video_config.resolution`	string	否	`SD` / `HD`

图生视频示例

{
  "model": "grok-imagine-1.0-video",
  "prompt": "保留主体，加入轻微运镜",
  "reference_images": ["https://example.com/source.jpg"],
  "video_config": {
    "video_length": 6,
    "aspect_ratio": "16:9",
    "resolution": "HD"
  }
}

返回 task_id，调 GET /v1/videos/{task_id} 轮询。

请求示例（文生视频）

请求示例（图生视频）

提交后立即返回

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "object": "video.generation",
  "status": "processing",
  "progress": 0,
  "created_at": 1730000000
}

错误码

400 参数错误（如 size 不被模型支持、参考图链接不可达）

401 令牌无效

402 余额不足（按预估费用预扣）

404 模型不存在或未开通

429 同时进行任务数超上限

500 服务端错误

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json

示例

{
    "model": "string",
    "prompt": "string",
    "video_config": {
        "video_length": 0,
        "aspect_ratio": "string",
        "resolution": "string"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Grok Imagine 1.0 视频生成