Grok Imagine API 接入教程:限额、价格与免费额度(2026)

想用代码批量生成图片和短视频,而不是在 Grok App 里一张张点?这篇把 xAI 的 Grok Imagine 从「它是什么」讲到「怎么调、怎么算钱、每天能跑多少张」,代码和限额规则都给全,免费额度和常见报错也一并说清。

赶时间?也可以先备一个统一 Key:用 GetModel 的 OpenAI 兼容接口按量调用 Claude / GPT / Gemini 等主流模型,余额全模型共享、不设单账号每日上限。模型与实时单价见 Claude Fable 5 等模型页。

Grok Imagine 是什么

Grok Imagine 是 xAI 推出的图像 + 短视频生成能力,消费端集成在 Grok App(iOS / Android)和 grok.com,需要 SuperGrok 或 X Premium 订阅才能用;开发端则通过 xAI 官方 API 开放,可以从文本直接生成图像,或把图像/文本合成为带音轨的短视频。

它和早期的 grok-2-image(纯文生图)是两回事:Imagine 这一代主打原生视频 + 音频,在同类视频模型里以低价著称——官方定价约 $4.2/分钟(含音轨),大致是 Google Veo 的三分之一、Sora 系列的几分之一。

要点先记住:消费端(App)按订阅走每日额度,开发端(API)按用量付费,两套计费逻辑完全独立。下面分别讲。

API 接入 + 代码

xAI 的接口与 OpenAI SDK 兼容,把 base_url 换成 https://api.x.ai/v1 即可复用现有代码。先到 xAI 控制台拿一个 xai-... 开头的 Key。

文生图(curl)

图像生成走 POST /v1/images/generations,输出为 jpg:

curl https://api.x.ai/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-2-image",
    "prompt": "一只戴宇航头盔的柴犬,赛博朋克霓虹背景",
    "n": 1
  }'

文生图(Python / OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    api_key="你的-xai-Key",
    base_url="https://api.x.ai/v1",
)

resp = client.images.generate(
    model="grok-2-image",
    prompt="一只戴宇航头盔的柴犬,赛博朋克霓虹背景",
    n=1,
)
print(resp.data[0].url)

上面代码用的 grok-2-image 是 xAI 文档中当前的图像生成模型;xAI 会随版本更新模型 ID,接入前请以 官方图像文档 为准。

生成视频

视频用 grok-imagine-video 模型,支持 文本 / 图像 / 视频 → 视频,按秒计费($0.05/秒),可用区域为 us-east-1 与 us-west-2。视频是耗时任务,通常以异步作业方式提交后轮询结果,具体请求体和轮询接口以 xAI 官方文档 为准,官网会随版本更新。

API 侧的限流是每秒请求数(视频模型约 10 req/s),和下文消费端的「每日张数」是两码事,别混。

每日限额与限流说明

这是大家最容易踩坑的地方——很多人不是没钱,是撞上了每日额度或高峰限流。分两层看:

消费端(Grok App / X)每日额度

xAI 官方不公开各档精确数字,以下为社区实测的近似值,会随版本波动:

套餐	价格(约)	图像 / 天	视频 / 天
免费(Free)	$0	基本不开放(仅文本对话)	—
SuperGrok Lite	~$10/月	~20	少量
X Premium	订阅内	—	~50
X Premium+	订阅内	—	~100
SuperGrok(Heavy)	~$30/月	~50(宣称不限)	~500

几条通用规则:

• 重置时间:额度按 UTC 0 点(北京时间 8:00)刷新,当天没用完不会累积到第二天。
• 高峰限流:xAI 有「公平使用」算法,高峰期会对重度用户降速,不少 SuperGrok 用户短时间连发 50–100 次后会撞到软上限。
• 免费档收紧:免费用户在 X 上如今基本只能用轻量文本模型,Imagine 的图像/视频是付费墙内功能。

API 端限流

开发端不看「每天几张」,而是按 RPS(每秒请求数) 限流,视频模型约 10 req/s;并发和额度按 Key 计。批量任务建议做好队列与指数退避重试,别一次性把请求全怼上去。

价格

官方 API 按量计费(以 x.ai 官网 实时价为准):

能力	说明	价格(约)
图像 · 标准	Imagine basic	$0.02 / 张
图像 · 高清	Imagine pro	$0.07 / 张
视频	grok-imagine-video	$0.05 / 秒(含音轨约 $4.2 / 分钟)

上表为 Imagine 系列 API 价;代码示例用的 grok-2-image 是当前文档里的图像生成模型,价位与高清档相近。具体模型名与实时价一律以 x.ai 为准。

消费端则是订阅制:SuperGrok $30/月 打包图像生成 + 每日视频额度,适合个人高频使用;而按量计费的 API 更适合批量、生产环境、按项目核算成本的场景。

如果你的场景是批量出图、生产环境、按项目核算成本,单账号每日额度和高峰限流会很碍事——这类需求更适合走按量计费。用 GetModel 这类聚合中转:OpenAI 兼容接口、按量计费、余额全模型共享,没有单账号每日额度这回事。可用模型与实时单价见 模型页 和价格页;想在同一段代码里同时调 Claude / GPT / Gemini,可参考一个 API Key 调用多家大模型。

常见问题(FAQ)

Grok Imagine 免费吗? 消费端的图像/视频生成基本是付费墙内功能(SuperGrok / X Premium 起),免费档主要是文本对话。开发端 API 没有免费额度,纯按用量付费。

限额多久重置? 消费端按每日 UTC 0 点刷新,未用完不结转。API 端不是每日额度,而是按每秒请求数限流。

官方 API 和 App 里的 Grok Imagine 有什么区别? 同一套模型,两套计费:App 按订阅走每日张数、适合手动创作;API 按量付费、适合程序化批量调用。生产集成一律走 API。

遇到 429(Too Many Requests)怎么办? 说明撞到限流。消费端等额度重置或避开高峰;API 端降低并发、加指数退避重试。批量场景建议上游做队列削峰,或用聚合中转分摊到多渠道。

生成内容能商用吗? 以 xAI 的服务条款和内容政策为准,商用前务必确认授权范围与合规红线(尤其涉及人物肖像、品牌元素时)。

---

准备开跑?注册 GetModel 拿一个 Key,一个 OpenAI 兼容接口按量调用 Claude / GPT / Gemini,余额全模型共享、不设单账号每日上限。模型与实时单价见 模型页 与价格页。

参考:xAI API 官网 · Grok Imagine Video 文档 · 图像生成文档