跳转到主要内容
POST

Grok Imagine Video

grok-imagine-video 是 Grok Imagine 系列的视频生成模型。该模型使用 JSON 请求体,支持文生视频和参考图视频生成。
  • 接口路径是 POST /v1/videos
  • 请求格式是 application/json
  • 文生视频只需要 modelpromptsecondsaspect_ratioresolution
  • 图生视频单图使用 image,多图使用 images
  • resolution 支持 480P720P
  • prompt 最多支持 4096 个字符。

方法与路径

响应示例

认证

Body

model
string
必填
固定传 grok-imagine-video
prompt
string
必填
视频生成提示词。最多 4096 个字符。
seconds
string
目标秒数。最小为 1 秒;建议按字符串传入,例如 "6"
aspect_ratio
string
宽高比。支持常见预设 1:116:99:164:33:43:22:32:11:219.5:99:19.520:99:20,也支持 数字:数字 的自定义比例。
resolution
string
输出清晰度。支持 480P720P,也兼容 480720 写法。
image
string
单张参考图。使用 data:image/png;base64,... 这类 data URI。
images
array<string>
多张参考图。数组成员使用 data:image/png;base64,... 这类 data URI。传多张图时不要同时传 image

Response

id
string
任务 ID。后续用 GET /v1/videos/{id} 查询结果。
object
string
对象类型,通常为 video
model
string
实际提交的模型名。
status
string
任务状态,常见值有 queuedprocessingcompletedfailedcancelled
progress
integer
任务进度百分比。
video_url
string
任务完成后的视频地址。也可以使用 GET /v1/videos/{task_id}/content 下载结果。

与 Grok 1.5 / 3 的区别

相关接口