创建视频

支持文生视频、图生视频和 Video-to-Video Remix。

POST/v1/video/generations

创建 Grok 视频生成任务，支持文本生成视频、图片生成视频和 Video-to-Video Remix。

模型 ID 示例为 grok-imagine-video。示例使用 MODEL_ID，实际可用模型以当前 API Key 返回的模型列表为准。

Authorization

bearerAuth

AuthorizationBearer <token>

在 Authorization Header 中使用 Bearer your-api-key。

In: header

Request Body

application/json

Grok 视频创建请求。

TypeScript Definitions

Use the request body type in TypeScript.

model*string

Grok 视频模型 ID，例如 grok-imagine-video。实际可用模型以当前 API Key 返回的模型列表为准。

Length1 <= length

prompt*string

描述期望生成或重绘的视频内容。

Length1 <= length

duration?integer

视频时长，单位为秒，仅文生/图生视频有效。取值范围为 1–15，默认为 5。Remix 模式不支持此字段，输出时长与输入视频一致且上限为 8.7 秒。

Range1 <= value <= 15

Default5

images?array<string>

图生视频使用的输入图片列表。与 image 二选一即可。

image?string

图生视频使用的单张图片，可为公网 URL 或 Base64 Data URI。与 images 二选一即可。

metadata?

传递给上游的扩展参数。该对象可透传 Grok 支持的其他高级参数，例如 seed、negative_prompt 和 fps。

平台会结合请求参数动态计算额度消耗，业务侧应一并保留 metadata，便于对账与复现。

Response Body

`application/json`

curl -X POST "https://example.com/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "一座在云端的赛博朋克城市",    "duration": 5,    "image": "https://example.com/init-frame.png",    "metadata": {      "resolution": "720p"    }  }'

{
  "id": "xai-task-12345"
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`