文生视频

POST

/grok/v1/videos/generations

纯文字生成视频。

参数：model 模型名（grok-imagine-video / grok-imagine-video-1.5），prompt 提示词，duration 时长（秒），aspect_ratio 画幅（如 16:9），resolution 分辨率（如 720p）。

提交后返回 request_id，用「查询视频结果」轮询，status 为 done 时拿到视频地址。视频是临时链接，请尽快下载。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

API Key

在 header 添加参数

x-api-key

示例：

x-api-key: ********************

Body 参数application/json必填

示例

{
    "model": "grok-imagine-video",
    "prompt": "一枚水晶能量火箭从火星红色沙丘上发射升空",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/grok/v1/videos/generations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "grok-imagine-video",
    "prompt": "一枚水晶能量火箭从火星红色沙丘上发射升空",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "request_id": "b4487cfb-987c-9008-8899-958638771c5d"
}

修改于 2026-07-23 01:30:06

多模态视频编辑

图生视频