Skip to main content
创建 Grok Imagine 视频任务
提交 Grok Imagine 异步图生视频任务。平台受理后立即返回任务 ID,视频生成结果通过 查询 Grok Imagine 视频任务 接口获取。
该接口当前需要传入参考图。建议始终显式传入 image_urls,并优先使用 1 张公网可访问的 HTTPS 图片直链。

请求参数

image_urls 必须是模型服务可下载的公网图片地址。不要传本地文件路径、data:image/...;base64asset://...、需要登录或会过期的临时 URL。若图片无法下载,任务会失败并退款。

示例


响应示例

保存响应中的 id,然后调用查询接口轮询任务状态。

计费说明

Grok Imagine 视频使用 video_second 作为公开用量单位。对于输入图 + 输出视频秒数的价格配置,控制台账单会拆分输入图费用和输出视频费用。 任务失败、取消或超时后,平台会退款到对应 API Key 余额。 更多说明见 Grok Imagine Video 001

常见错误

授权

Authorization
string
header
默认值:sk-your-api-key
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
model
string
必填

平台开通的 Grok Imagine 视频模型名称。

示例:

"grok-imagine-video-1.5-preview"

prompt
string
必填

视频提示词,描述主体、动作、环境、镜头、风格等。

示例:

"一只哥斯拉在深圳湾海岸线与城市天际线之间缓慢行走,低机位电影镜头,电影感,写实,高细节"

image_urls
string[]
必填

参考图 URL 数组。建议传 1 个公网可访问的 HTTPS 图片直链;如账号开通的模型配置支持多参考图,可按实际配置传入。 不支持本地文件路径、data:image/...;base64asset://...、需要登录或会过期的临时 URL。

Minimum array length: 1
示例:
duration

视频时长(秒)。建议显式传入;常见范围为 5 到 15,部分模型配置要求 6 秒起。

示例:

6

aspect_ratio
string

画面比例。通用值为 16:99:162:3;部分模型配置还支持 3:21:1

示例:

"16:9"

resolution
string

分辨率档位。部分模型配置支持 480p720p;未传按模型配置默认值处理。

示例:

"720p"

size
string

resolution 的兼容别名。若同时传入 resolutionsize,两者应保持一致。

示例:

"720p"

响应

任务已受理并进入队列。

id
string
必填

平台任务 ID,用于查询任务。

示例:

"vidtask_3cb6299b32d24f93a82e8a74b3e06161"

object
enum<string>
必填
可用选项:
video.generation.task
created
integer
必填

任务创建时间,Unix 秒。

model
string
必填

请求中的平台模型名称。

status
enum<string>
必填

初始状态,通常为 queued

可用选项:
queued
expires_at
integer

任务过期时间估算,Unix 秒。