概述
Grok Imagine 视频是 xAI 视频生成模型的官方通道:请求经 API易 转发到 xAI 官方 API,价格与 xAI 官网一致,按生成秒数与分辨率计费。接口是 OpenAI Videos 兼容的异步任务式端点(/v1/videos),支持文生视频和图生视频,生成的视频自带音轨。
本通道提供三个型号:
grok-imagine-video:基础款,480p / 720pgrok-imagine-video-1.5:新一代,480p / 720p / 1080pgrok-imagine-video-1.5-lite:1.5 轻量版,480p / 720p 单价最低
视频生成 API
Grok Imagine 官转生图
GrokOfficial 分组,与官网同价按档计费的图片生成。让 AI Agent 帮你接入
复制这段提示词,粘贴给 Codex / Claude Code / Cursor
它会先抓本页的纯文本版(任意文档页地址后加 .md),再按你项目的技术栈写代码——异步三步流程、默认 480p 8 秒、审核拦截照常计费、成片立即转存这几个高频坑已经写死在要求里。
帮我在当前项目里接入 / 排查 Grok Imagine 视频生成(文生视频 + 图生视频)。
先读文档再动手:抓 https://docs.apiyi.com/api-capabilities/grok-imagine-video/overview.md 拿到本页纯文本版; …
- 模型名三选一:
grok-imagine-video、grok-imagine-video-1.5、grok-imagine-video-1.5-lite…
共 8 条接入要求,点下方按钮复制完整版
模型与定价
价格与 xAI 官网一致,按生成视频的秒数计费,单价由模型与分辨率决定:分组介绍
谁可以开通
怎么申请
联系企业微信客服
GrokOfficial(Grok Imagine 官转)。说明使用场景与内容管控措施
开通后切换令牌分组
GrokOfficial 分组。请到控制台令牌页把调用本通道的令牌分组切到 GrokOfficial,计费模式选 按量优先 或 按量计费。GrokOfficial 时调用返回 503(当前分组无可用渠道),重试无效,需要先完成开通。令牌「计费模式」不要选 按次计费:本通道按秒计费,按次计费的令牌路由不到,同样会返回 503。技术规格
端点一览
完整流程(Python)
关键参数详解
size(分辨率与宽高比)
size 用 宽x高 的像素写法,网关按短边换算分辨率档,按宽高比取最接近的一档:
"480p" / "720p" / "1080p",或者不用 size、改传 xAI 原生字段 resolution(480p / 720p / 1080p)加 aspect_ratio(如 9:16),两者同时传时以 resolution / aspect_ratio 为准。都不传时按 480p 生成。
seconds(时长)
取值 1–15 的整数,字符串("5")或数字(5)都可以,默认 8 秒。超出范围返回 400:duration must be an integer between 1 and 15。费用与秒数成正比,测试阶段建议用 1–2 秒。
input_reference(图生视频)
传一张输入图即可转为图生视频,三种写法任选:
- 公网图片 URL:
"input_reference": "https://example.com/first-frame.jpg" - base64 Data URI:
"input_reference": "data:image/jpeg;base64,/9j/4AAQ..." - multipart 上传文件:
-F "[email protected]"
prompt 用来描述动作与镜头(如「猫慢慢转过头」),输出画幅跟随输入图。每张输入图另收 $0.002(grok-imagine-video)或 $0.01(1.5 / 1.5-lite)。
最佳实践
先用 1–2 秒、480p 试提示词
grok-imagine-video-1.5-lite 的 480p / 720p 单价最低,适合批量试错。每次都显式传 size 和 seconds
轮询间隔 5–10 秒,设总超时
处理审核拦截
error.code:moderation_blocked 表示被拦截、没有成片但已计费。换个表述再提交,不要原样重试。成片立即转存
completed 后立即用 /content 下载到自己的存储,不要把下载链接长期保存或直接给终端用户。错误码与重试
常见问题
调用一直返回 503,是渠道挂了吗?
调用一直返回 503,是渠道挂了吗?
GrokOfficial,或令牌计费模式是「按次计费」。前者按 分组介绍 申请开通;后者把计费模式改成 按量优先 或 按量计费 即可。为什么我生成的视频是 480p、8 秒?
为什么我生成的视频是 480p、8 秒?
size 和 seconds,就按 480p、8 秒生成并计费。请显式传 size(如 "1280x720")和 seconds。任务显示 completed,但下载不到视频?
任务显示 completed,但下载不到视频?
error.code: "moderation_blocked"。有的话说明这条视频被 xAI 的内容审核拦截了:任务状态仍是 completed,但没有成片,并且照常计费(xAI 对被拦截的视频同样收费)。请调整提示词或输入图后重新提交。关掉音频能便宜吗?
关掉音频能便宜吗?
图生视频的输出比例为什么和我传的 size 不一样?
图生视频的输出比例为什么和我传的 size 不一样?
支持视频编辑、视频延长、多张参考图吗?
支持视频编辑、视频延长、多张参考图吗?
三个型号怎么选?
三个型号怎么选?
- 要 1080p →
grok-imagine-video-1.5(画质最好)或grok-imagine-video-1.5-lite(更便宜) - 批量出 480p / 720p、控制成本 →
grok-imagine-video-1.5-lite($0.02 / $0.03 每秒) - 已在用基础款、只需 480p / 720p →
grok-imagine-video
相关文档
- Grok Imagine 视频生成 API - 带 Playground 的提交接口参考
- Grok Imagine 官转生图 - 同一分组,与官网同价按档计费
- Grok 系列模型调用指南 - xAI 文本模型
- 充值加赠活动