创建视频任务

开发中

POST

/v1/videos

本文档适用于 grok-video-1.5 与 grok-video-3 系列。请求体使用 multipart/form-data，参考图通过文件字段上传。
接口路径是 POST /v1/videos。

input_reference 是参考图字段，支持重复上传多张图片文件（二进制）。

grok-video-1.5 与 grok-video-3 支持 10s / 15s 两种时长档位。

Pro 模型固定 10s，Max 模型固定 15s。

Grok Imagine 系列使用 JSON 请求体

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数multipart/form-data必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.xgapi.top/v1/videos' \
--header 'Authorization: Bearer <token>' \
--form 'model="grok-imagine-video-1.5-preview"' \
--form 'prompt=""' \
--form 'input_reference=@""' \
--form 'aspect_ratio="2:3"' \
--form 'seconds="15"' \
--form 'size="1280x720"' \
--form 'image_reference=""'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "id": "task_SSTaYlmbHJBYhxGwX1qPMbo7CQqsAWHc",
    "task_id": "task_SSTaYlmbHJBYhxGwX1qPMbo7CQqsAWHc",
    "object": "video.generation",
    "model": "",
    "status": "processing",
    "progress": 0,
    "created_at": 1781062491
}

修改于 2026-07-22 07:48:09

查询结果

Grok Imagine Video