Grok Imagine Video 专题

视频模型中转站:Grok 视频生成 API 怎么接

使用统一 OpenAI 兼容接口创建 Grok 视频任务,提交后通过 request_id 轮询状态,完成后获取视频地址或 content 内容。

主词:Grok 视频生成 API接口:/v1/videos/generations

更新:2026-08-21

生成方式异步任务
时长1-15 秒,默认 8 秒
分辨率480p / 720p / 1080p

流程:创建任务 → 保存任务 ID → 轮询状态 → 下载。不要把聊天 timeout 套到视频上。需要 1 秒 0.1 元样本时,改走已开通的 Seedance 2.5。

1. 为什么视频不能当聊天调

Grok 视频是异步的。请求成功只代表任务已受理,不代表成片。轮询间隔、最大等待和重复提交规则要写在业务里,否则容易双扣。

  1. 提交后立刻记下任务 ID 和提交时间。
  2. 只在状态明确失败且账单无成功扣费时重提。
  3. 下载完成后再把秒数写入自己的台账。

2. 创建任务时记录什么

提交前记录模型代号、首帧或参考图 URL、时长和分辨率;提交后立即保存 request_id。请求成功只表示任务已受理,不能代替成片验收。

阶段验收记录
创建HTTP 状态、request_id、提交时间
处理中最近一次状态、轮询次数、超时阈值
完成视频 URL、实际时长、余额变化

3. 状态与下载

轮询只针对同一个任务 ID,轮询间隔从 15 到 30 秒起步,处理中的任务不要并发重复查询。状态为处理中时延长等待;明确失败后先检查账单,再决定是否重提。下载完成后校验文件可播放、时长符合预期,不要把下载失败误判为生成失败。

4. 和 Seedance 怎么并列

Grok 视频Seedance 2.5
计费按任务/秒,以控制台为准限时 1 秒 0.1 元,需开通
输入文生/图生视模型而定文生、图生、首帧、参考图
验收短时长样本先 1 到 2 秒

两套任务 ID 不要共用一个轮询器,两份台账分开记,单价口径也不同。开通 Seedance 找 客服 QQ 49098022 或 Telegram 群组,不要发完整 Key。Seedance 在 独立子站开通;主站与子站的账号、余额、API Key 和账单不互通。

5. 常见问题

轮询超时要不要马上重提?

不要。先查任务状态。处理中就继续等;明确失败且未成功扣费再重提。

图生视频缺首帧会怎样?

通常无法按预期成片。先确认图片 URL 可访问,再提交。