跳转到主要内容
POST
创建视频

创建视频

Grok 统一视频入口使用 POST /v1/video/create,请求体为 JSON。与 OpenAI 格式的 Grok 视频生成 不同,本接口使用 imagesaspect_ratiosize 等字段,并支持在 prompt 中通过 @img1@img2 引用多图。
  • 路由入口是 POST /v1/video/create
  • 参考图通过 images 数组传入 URL 或 base64;文生视频可传 []
  • 常见模型为 grok-video-3,以当前渠道实际可用模型为准。
  • 提交成功后返回 idtask_idstatus,后续用 查询任务 轮询结果。

方法与路径

请求示例

响应示例

实际响应字段可能因渠道略有差异,请以返回中的 idtask_id 作为后续查询凭据。

认证

Body

model
string
必填
模型名称,例如 grok-video-3
prompt
string
必填
提示词。多图参考时可在文案中使用 @img1@img2 等占位符,对应 images 数组下标顺序。
images
array<string>
必填
参考图列表,元素为 URL 或 base64 data URI。文生视频可传 [];首尾帧一般按顺序传 2 张;多图参考最多支持 6 张。
aspect_ratio
string
必填
视频比例。可选 16:99:162:33:21:1
size
string
必填
分辨率规格,传 720P1080P
duration
integer
视频时长(秒)。默认 10,支持 61015

Response

id
string
任务 ID,查询时作为 id 参数;部分响应可能仅返回 task_id
task_id
string
上游任务 ID,与 id 可能并存,以实际响应为准。
status
string
任务状态,常见值包括 processingcompletedfailed
status_update_time
integer
状态最近更新时间(Unix 时间戳)。
created_at
string
创建时间,部分响应为 RFC3339 字符串。

相关接口