grok-imagine-video-1.0
- 面向高想象力短片、角色动作延展和概念镜头预览
- 提交成功后返回视频任务 ID
- 当前平台开放
default组 - 支持文生视频与参考图生视频
- 当前统一协议只下发
1张参考图作为图片参考输入 duration支持6、10、12、16、20秒aspect_ratio支持16:9、9:16resolution支持480p、720p
请求鉴权
所有接口均需要使用 Bearer Token 进行认证。提交任务接口
请求参数
分组参数说明
grok-imagine-video-1.0当前平台仅开放default组。- 调用时不需要单独传分组字段,实际参数能力按当前绑定分组执行。
- 对外统一只使用逻辑模型名
grok-imagine-video-1.0,平台会按当前分组自动应用对应能力边界。 standard组当前不开放该模型。
响应
提交成功响应示例:任务查询接口
使用示例
文生视频
参考图生视频
注意事项
images当前最多传1张;统一请求会将该图片作为参考输入下发。- 当前
grok-imagine-video-1.0只在default组开放,不开放standard。 - 提交成功后请使用
GET /v1/videos/{task_id}继续轮询结果。
异步状态与失败响应
视频任务状态只使用queued、in_progress、completed、failed。处于 queued 或 in_progress 时继续调用查询接口;只有 completed 状态才读取顶层 result_url。
任务失败时保持视频对象结构,并返回顶层 error 与 fail_reason,不要按图片接口读取 code/data/works: