跳转到主要内容
POST
Grok 视频生成

Grok 视频生成

OpenAI 格式入口。若需使用统一视频的 POST /v1/video/create,请见 创建视频 Grok 视频生成接口使用 multipart/form-data 提交,请按这里的字段组织请求。
  • 接口路径是 POST /v1/videos
  • input_reference 是参考图字段,支持重复上传多张图片。
  • grok-video-3-pro 会自动固定为 10 秒,grok-video-3-max 会自动固定为 15 秒。
  • 基础版 grok-video-3 没有额外固定秒数逻辑,按实际传参处理。

当前可用模型

  • grok-video-3
  • grok-video-3-pro
  • grok-video-3-max

方法与路径

请求示例

响应示例

认证

Body

model
string
必填
模型名称。当前 Grok 系列可用值为 grok-video-3grok-video-3-progrok-video-3-max
prompt
string
必填
提示词。
aspect_ratio
string
视频尺寸比例。可选为 16:9, 9:16, 2:3, 3:2, 1:1。
seconds
integer
目标秒数。对 grok-video-3-progrok-video-3-max,会自动纠正为固定值。
size
string
分辨率档位,常用值是 720P1080P
input_reference
file
参考图文件。可重复传多次,对应多张 input_reference 上传。

Response

id
string
任务 ID。
object
string
固定为 video
model
string
实际提交的模型名。
status
string
任务状态,常见值有 queuedprocessingcompletedfailedcancelled
progress
integer
进度百分比。
created_at
integer
创建时间戳。
size
string
输出清晰度档位。

使用场景

文生视频

只传 modelpromptsecondssize 这组字段即可。

图生视频

在文生视频的基础上追加一个或多个 input_reference 文件。

固定时长模型

如果你传的是 grok-video-3-progrok-video-3-max,应预期服务端按固定秒数处理。

相关接口