跳转到主要内容
POST
模型名兼容提示:本接口同时兼容别名 grok-imagine-1.5-video-ext,它等价于 grok-imagine-1.5-video-apimart,两者可互换使用、效果一致。

认证

Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

请求参数

model
string
默认值:"grok-imagine-1.5-video-apimart"
必填
视频生成模型名称支持的模型:
  • grok-imagine-1.5-video-apimart - Grok 视频生成(兼容别名 grok-imagine-1.5-video-ext
示例:"grok-imagine-1.5-video-apimart"
为兼容旧版调用,别名 grok-imagine-1.5-video-ext(对应 grok-imagine-1.5-video-apimart)仍可正常使用。
prompt
string
必填
视频内容描述,支持中英文
size
string
默认值:"16:9"
视频尺寸可选值:
  • 16:9 - 横屏(默认)
  • 9:16 - 竖屏
  • 1:1 - 正方形
  • 3:2 - 横屏
  • 2:3 - 竖版
duration
integer
默认值:6
视频时长(秒)取值范围:6-30(最短 6 秒,最长 30 秒)⚠️ 注意: 必须输入纯数字(如 6),不要加引号,否则会报错
quality
string
默认值:"480p"
视频质量可选值:
  • 480p - 标清(默认)
  • 720p - 高清
image_urls
string[]
参考图像的 URL 列表限制:
  • 最多 7 张图片
  • 必须是公网可访问的 URL
  • 不支持 base64 格式
上传参考图之后,宽高比会自动匹配参考图的宽高比

响应

code
integer
响应状态码
data
object[]
响应数据数组
查询任务结果视频生成为异步任务,提交后会返回 task_id。使用 获取任务状态 接口查询生成进度和结果。

使用场景

场景 1:文生视频

场景 2:图生视频