Skip to main content
POST

请求头

Authorization
string
必填

Bearer API Key,例如 Bearer sk-...。

示例:

"Bearer sk-..."

请求体

application/json

Grok Imagine 视频创建请求(POST /v1/videos)。

model
string
必填

视频模型 ID。模型 ID 以模型广场为准。常用:grok-imagine-video-1.5-preview、grok-imagine-video;亦可有 grok-video-1.5-pro、grok-video-1.5-max 等变体(以你账号开通为准)。

示例:

"grok-imagine-video-1.5-preview"

prompt
string
必填

视频提示词,最大约 4096 字符。写清主体、场景、运动与风格。

Maximum string length: 4096
示例:

"雨夜霓虹街头,一辆复古跑车驶过湿润路面"

seconds
string

目标时长(秒),建议传字符串,如 "6"、"8"。最小 1。也可用整数 duration。

示例:

"8"

duration
integer

seconds 的整数写法。

必填范围: x >= 1
aspect_ratio
enum<string>

画幅宽高比。预设见枚举;亦支持自定义 数字:数字。

可用选项:
1:1,
16:9,
9:16,
4:3,
3:4,
3:2,
2:3,
2:1,
1:2,
19.5:9,
9:19.5,
20:9,
9:20
示例:

"16:9"

resolution
enum<string>

输出清晰度。支持 480P / 720P(大小写不敏感,亦可写 480 / 720)。

可用选项:
480P,
720P,
480,
720,
480p,
720p
示例:

"720P"

image
string

单张参考图。推荐 data:image/...;base64,... Data URI,也可为 HTTPS URL。不要与 reference_images 同时使用。

reference_images
string[]

多张参考图(Data URI 或 URL)。不要与 image 同时使用。

images
string[]

reference_images / 单图的兼容数组写法。

响应

任务已接受。

id
string

任务 ID。

object
string
示例:

"video"

model
string
status
string

如 queued / in_progress / completed。

progress
integer
created_at
integer
seconds
string
size
string