Grok创建视频，文生视频限制 grok 1.0

POST

/v1/videos

模型名称：grok-imagine-1.0-video

字段	类型	必填	说明
`model`	string	是	固定传 `grok-imagine-1.0-video`
`prompt`	string	是	视频生成提示词
`reference_images`	string[]	否	图生视频参考图 URL。当前推荐传 1 张图
`video_config.video_length`	number/string	否	视频时长，支持 `6`、`10`
`video_config.aspect_ratio`	string	否	画幅比例，支持 `16:9`、`9:16`、`1:1`、`2:3`、`3:2`
`video_config.resolution`	string	否	可传 `HD` 或 `SD`，作为兼容字段

画幅会自动转换为上游尺寸：

aspect_ratio	实际 size
`16:9`	`1280x720`
`9:16`	`720x1280`
`1:1`	`1024x1024`
`2:3`	`720x1280`
`3:2`	`1280x720`

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json

示例

{
    "model": "grok-imagine-video-1.5-preview",
    "prompt": "make the cat move, gentle motion",
    "image_url": "https://gips0.baidu.com/it/u=1690853528,2506870245&fm=3028&app=3028&f=JPEG&fmt=auto?w=1024&h=1024",
    "seconds": "4",
    "size": "720x1280"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/videos' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "grok-imagine-video-1.5-preview",
    "prompt": "make the cat move, gentle motion",
    "image_url": "https://gips0.baidu.com/it/u=1690853528,2506870245&fm=3028&app=3028&f=JPEG&fmt=auto?w=1024&h=1024",
    "seconds": "4",
    "size": "720x1280"
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "id": "video_55cb73b3-60af-40c8-95fd-eae8fd758ade",
    "object": "video",
    "model": "veo_3_1",
    "status": "queued",
    "progress": 0,
    "created_at": 1762336916,
    "seconds": "8",
    "size": "16x9"
}

修改于 2026-06-09 14:43:24

Grok创建视频，带图片

任务查询进度