Grok Imagine API 怎么用？Python 调用和三个模型实测对比

Grok Imagine API 是 xAI 的图片和视频接口，现在能调用的图像模型有三个：grok-imagine-image、grok-imagine-image-quality 和 grok-imagine-image-2.0。我们在 2026 年 10 月 18 日用同样四个提示词把三个都跑了一遍，Grok Imagine 2.0 赢了其中三项。

下面讲清楚：选哪个模型、一段复制就能跑的 Python 代码、xAI 每张图收多少钱，以及要注意什么。

先说结论

• 默认用 Grok Imagine 2.0（grok-imagine-image-2.0）。我们的测试里它的海报排版、产品图和照片都最好，xAI 标价每张 0.04 美元起。
• 要大量出草稿，就用原版 grok-imagine-image：xAI 每张 0.02 美元，海报上的字也写对了。
• 别再用 grok-imagine-image-quality：xAI 11 月 2 日就下线它，而且它在我们的海报上自己编了一个地址。
• 每张图都在 7 到 18 秒之间出来。

Grok Imagine API 是什么？

它是 xAI 的图片和视频接口，2026 年 1 月 28 日开放（xAI）。图像 2.0 在 2026 年 8 月 7 日发布，xAI 说它在图片生成和改图两项上都排世界第二（xAI）。

三个模型在 OmniaKey 上都能调：Grok Imagine、Grok Imagine Quality 和 Grok Imagine 2.0。OmniaKey 在卖这几个模型的接口，所以测试通过它来跑；文中价格都是 xAI 的官方价，不是我们的价格。

该用哪个 Grok Imagine 模型？

用 Grok Imagine 2.0，除非你只要便宜的草稿。我们给三个模型各跑一次同样的四个提示词，不设尺寸和比例，按原图大小逐张看。

测试 1：海报上的字

提示词：

A minimalist poster for a neighborhood coffee shop opening. Large bold headline text "GRAND OPENING", smaller text below "Saturday 9 AM", a simple line drawing of a coffee cup, cream background, dark brown ink.

三个模型两行字都写对了（见上面那张图）。Grok Imagine 2.0 的版式最讲究，日期上下还加了细线。Quality 多写了一行谁都没要求的字：

结论： 要好看选 2.0，只要字对选原版。印传单别用 Quality，凭空多出来的字最要命。

测试 2：写实照片

提示词：

A realistic photo of an elderly fisherman mending a blue net on a wooden dock at sunrise, soft golden light, gulls in the background, shallow depth of field.

• Grok Imagine： 金色晨光很好看，场景可信，但整个码头都是清楚的。
• Quality： 人和场景都对，但渔夫在画面里偏小，细节也软一些。
• Grok Imagine 2.0： 近景、背景虚化，只有它明显做到了"浅景深"。

结论： 2.0。

测试 3：产品图

提示词：

Studio product photo of a matte black wireless earbud case, lid open, both earbuds inside, on a pure white background, soft shadow, sharp focus, no text, no logo.

三个模型每个细节都做对了：开盖、两只耳机、白底、没有 logo。原版的产品在画面里偏小，Quality 是斜着拍的。Grok Imagine 2.0 产品占满画面、细节清楚，可以直接拿去做商品图。

结论： 2.0。

测试 4：数数量

提示词：

Top-down photo of a wooden table with exactly three red apples on the left and exactly two green pears on the right, nothing else on the table.

三个模型都是左边三个苹果、右边两个梨，桌上没有别的东西。原版的梨是立着拍的，不是从上往下；2.0 的梨偏黄，不太像青梨。

结论： 数量打平，俯拍效果 Quality 最好。

怎么用 Python 调用？

三步：建任务、查到它完成、下载图片。把 key 放进环境变量，然后运行：

import os
import time
import uuid

import requests

API = "https://api.omniakey.com/v1/media/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['OMNIAKEY_API_KEY']}"}

# 1. 建任务。只有原样重试同一个请求时，才复用同一个 Idempotency-Key。
job = requests.post(
    API,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json={
        "model": "grok-imagine-image-2.0",
        "type": "image",
        "operation": "generate",
        "input": {"prompt": "A flat illustration of a red bicycle leaning on a yellow wall, morning light"},
    },
    timeout=30,
)
job.raise_for_status()
task = job.json()
print("task:", task["id"], task["status"])

# 2. 看 status 轮询，直到任务结束。
while task["status"] in ("queued", "processing"):
    time.sleep(2)
    task = requests.get(f"{API}/{task['id']}", headers=HEADERS, timeout=30).json()

if task["status"] != "succeeded":
    raise SystemExit(f"job ended {task['status']}: {task.get('error')}")

# 3. 马上下载：签名链接很快就会过期。
asset = task["assets"][0]
with open("bicycle.jpg", "wb") as f:
    f.write(requests.get(asset["url"], timeout=60).content)
print("saved bicycle.jpg", asset["mime_type"], asset["byte_size"], "bytes")

我们 10 月 18 日跑的时候，它输出了下面两行，从开始到存好一张 1248 × 832 的 JPEG 用了 16 秒：

task: task_LBCu6Lr8hyD4RH25JfiOixJHPHi3Cd0o queued
saved bicycle.jpg image/jpeg 267732 bytes

想换模型，只改 model 那一个值就行。

Grok Imagine API 多少钱？

xAI 按张收费，价格看模型、分辨率，2.0 还看质量档。下面是 xAI 价格页上的官方价（10 月 18 日核对）：

2.0 生成新图时默认用低质量档，所以在 xAI 那边一张 1K 图是 0.04 美元。在 xAI 自己的 API 上，违反使用规则的请求照样收费。通过 OmniaKey 调用是每张一个固定价（以模型页为准），任务失败会自动退款。

要注意什么？

• 通过 OmniaKey 不能改图。 xAI 自己的 API 里，2.0 能带最多 5 张参考图改图；但通过 OmniaKey，Grok 只能生成新图。要改图，换一个支持改图的模型，比如 Nano Banana 2.1。
• 比例由模型自己定。 不设比例时，Grok 给海报出了竖图、给场景出了横图，尺寸都在 100 万像素左右（832 × 1248 到 1280 × 720）。
• Quality 11 月 2 日下线。 之后 xAI 会用 2.0 低质量档来回应 grok-imagine-image-quality 的请求，所以现在就换掉它。
• 遇到 400 重试一次。 我们 14 次调用里有一次返回 400，钱自动退回，原样重试就成功了。

国内怎么用

在国内用 OmniaKey 调 Grok Imagine，可以用支付宝或微信支付人民币直充，不用先办海外信用卡。一个 key 能调多家模型，三个 Grok 图像模型换 model 字段就能切换。具体价格看模型页。

总结

大多数情况直接调 grok-imagine-image-2.0：我们的四项测试它赢了三项，xAI 那边一张 1K 图 0.04 美元。要大量出便宜的草稿就用原版，Quality 在 11 月 2 日之前换掉。

常见问题

Grok Imagine API 免费吗？

不免费。xAI 给每个 Grok 图像模型都标了按张的价格，最便宜的是原版，每张 0.02 美元。

能通过 API 用 Grok Imagine 做视频吗？

能。xAI 的视频模型按秒计费，比如 Grok Imagine Video 1.5 在 480p 是每秒 0.08 美元。在 OmniaKey 上看 Grok Imagine Video 1.5。

出来的图多大？

默认 100 万像素左右。xAI 的指南写的是默认 1K、可选 2K，不设比例时由模型自己挑。

11 月 2 日之后 grok-imagine-image-quality 会怎样？

xAI 还会响应这个模型 ID，但实际用的是 Grok Imagine 2.0 低质量档，按 2.0 的价格收费。原版 grok-imagine-image 不受影响。