跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。

Grok Imagine Video 1.5 图生视频

使用描述主体运动、镜头运动和声音的提示词让单张图片动起来。图片作为首帧,并决定视频的宽高比。

请求

将 model 设为 xai/grok-imagine-video-v1.5/image-to-video。下列参数放在 input 中。可选的 callback_url 放在请求根级。

prompt

必填字符串。用 1–4,096 个字符描述场景和期望的运动,至少包含一个非空白字符。

image_urls

必填数组,包含恰好一个可公开访问的 HTTP(S) 图片 URL。URL 需带主机名,且无需凭证即可访问。

resolution

可选字符串:480p、720p 或 1080p。默认:720p。

duration

可选整数,1 到 15 秒。默认:6。

授权

Authorization
string
header
必填

使用 VIDGO_API_KEY。

请求体

application/json

model 和 callback_url 放在请求根级,生成参数放在 input 中。

model
enum<string>
必填
可用选项:
xai/grok-imagine-video-v1.5/image-to-video
示例:

"xai/grok-imagine-video-v1.5/image-to-video"

input
object
必填
callback_url
string | null

可选,接收任务完成通知的公开 HTTP(S) 地址,建议使用 HTTPS。省略、传 null 或传空字符串即不启用回调。

响应

任务已提交

code
enum<integer>
必填
可用选项:
200
data
object
必填