Skip to main content
视频生成接口为异步接口。提交任务后平台立即返回任务 ID,视频在后台生成完成后通过查询接口获取结果。

仅使用文本或公网 URL

适用于文生视频、图生视频(直接传公网 HTTPS URL)等简单场景。
  1. 调用 POST /v1/videos/generations 提交任务。
  2. 保存响应中的 id
  3. 轮询 GET /v1/videos/generations/{id} 查询任务状态(建议间隔 5–10 秒)。
  4. status=succeeded 时,从 content.video_url 获取视频,请及时下载转存,URL 有有效期。

使用平台素材库(私域素材)

适用于需要复用已上传的图片、视频、音频素材的场景。
  1. 调用 POST /v1/assets 提交公网 HTTPS 素材 URL,或使用 multipart/form-data 上传本地文件。
  2. 轮询 GET /v1/assets/{id},等待 status=active
  3. 在视频生成请求的 content[].*.url 中传入 asset://asset_xxx必须保留 asset:// 前缀
  4. 按”仅使用公网 URL”的第 2–4 步完成任务提交与轮询。

接口清单


Grok Imagine Video 001 仍使用 Grok Imagine 公开入口。可用模型名、时长、比例、分辨率和价格以 /v1/models 与控制台配置为准,详见 Grok Imagine Video 001

轮询建议

不要高频轮询,建议间隔 5–10 秒,最短不低于 3 秒。视频生成通常需要 30 秒至数分钟,高频请求不会加快结果返回。

支持的输入组合

音频不建议单独输入,应至少搭配图片或视频。