POST
使用 grok-imagine-video-1.5-preview 根据参考图和提示词创建视频任务。API Key 需绑定包含此模型的视频分组。

请求参数

string
required
填写 grok-imagine-video-1.5-preview,并绑定包含此模型的视频分组。
string
required
描述动作、镜头和场景。建议使用清晰、精炼的提示词,避免堆叠互相矛盾的动作。
string | integer
目标视频时长,单位为秒。示例使用 "4",可选时长见分组的模型说明。
string
画面宽高比,例如 16:9、9:16、1:1。
string
视频分辨率。示例使用 720P,可选档位见分组的模型说明。
array<string>
参考图 URL 数组。素材链接需可公开访问;多图模式需使用已开通该能力的分组。
object
单张参考图的另一种输入格式:{"image_url":"https://example.com/image.png"}。与 images 二选一。

使用参考图

  • 单图:在 images 中传入一张图片,并在 prompt 中描述主体动作和镜头变化。
  • 多图:使用已开通多图能力的分组,并在提示词中说明每张图片的用途,例如人物参考、场景参考。
  • 素材地址:将示例 URL 替换为实际图片链接。

查询生成结果

保存创建响应中的任务 ID,通过Grok 视频查询与下载查看进度,完成后下载视频。