Grok Imagine 今天退役了什么？旧模型还能用吗？一文看懂 2.0 迁移的 4 个关键点

作者注：一文看懂 Grok Imagine 旧标识退役的影响范围、旧接口兼容情况、官方价格变化，以及迁移到 2.0 时如何控制质量和成本。

今天（2026 年 11 月 2 日），xAI 正式执行 Grok Imagine 图像模型迁移计划，退役的是 API 模型标识 grok-imagine-image-quality，而不是整个 Grok Imagine。旧标识仍能调用，但请求会由 grok-imagine-image-2.0 以 Low 质量处理，1.0 模型 grok-imagine-image 不受影响。

这不是小道消息，也不是 2.0 今天才发布。xAI 已在官方迁移指南中确认这项安排，并在 9 月 2 日提前 60 天发出通知。本文的迁移规则和价格均来自 xAI 官方文档.

核心价值：3 分钟判断你是否受影响、旧接口还能否使用、代码要不要修改，以及如何选择质量参数来控制成本。

Grok Imagine 今天退役了什么：核心信息速览

这次变化最容易被误读的地方，是把“旧标识退役”理解成“服务停用”。按照官方说明，使用旧名称的请求不会仅因名称退役而必然失败，服务端会把它转交给 2.0 处理。但旧标识能调用，不代表背后运行的仍是旧模型。

Grok Imagine 2.0 迁移的事件脉络

• 5 月 15 日：grok-imagine-image-pro 退役，请求重定向到 grok-imagine-image-quality。
• 8 月 7 日：xAI 发布 Imagine Image 2.0，API 名称为 grok-imagine-image-2.0，消费者产品同步上线新的 Quality Mode。
• 8 月 28 日：2.0 API 新增 quality=auto，未填写时的默认值由 Medium 改为 Auto；编辑参考图上限从 3 张增至 5 张，并新增 21:9、5:2 宽高比。
• 9 月 2 日：xAI 发布迁移说明，预告旧 Quality 标识将在 60 天后退役。
• 11 月 2 日：迁移规则正式生效。

Grok Imagine 旧模型还能用吗：谁受这次迁移影响

判断是否受影响，先查代码和配置中的 model 值。如果你只在 Grok 网页或手机客户端中生成图片，这份公告直接涉及的仍是 API 标识，不能据此认为某个界面选项今天被取消。

代码不是今天就必须修改，因为旧标识不会因这次退役而直接失效。但如果业务对成品风格、编辑效果或成本有要求，仍建议主动升级，这样可以自行选择模型和质量档位。

需要注意，请求结构兼容不等于画面一致。底层模型变化后，相同提示词也可能产生不同的风格、构图和细节，这是模型迁移常见的工程风险。目前的公开资料并不能说明今天发生了大规模质量事故，但生产环境仍应抽样复查。

Grok Imagine 2.0 价格怎么变：不是所有路径都更便宜

xAI 官方价格以输出图像计费，2.0 的价格由质量档位和分辨率共同决定。自动迁移到 Low 后，每张输出图便宜 0.01 美元；如果主动选择 Medium，每张则比旧 Quality 贵 0.01 美元。

此外，2.0 和旧 Quality 的每张输入参考图都是 0.01 美元。1.0 的输出价为 1K、2K 每张 0.02 美元，输入图为每张 0.002 美元。官方价格表虽然列出了 1.5K，但生成参数文档目前只明确写出 1k 和 2k，因此不要未经测试就在生产代码中使用 resolution="1.5k"。

Grok Imagine 批量生图成本推算

下表按官方单价计算，属于理论成本，不是真实企业账单。其中纯文生图案例不含参考图输入、失败重试、税费和第三方平台费用。

编辑业务要把输入费算进去。例如，使用 5 张参考图输出 1 张 2K Medium 图片时，输入费为 0.05 美元，输出费为 0.08 美元，理论总价是 0.13 美元。官方所说的每张便宜 0.01 美元主要指输出价格，因此编辑任务的总降幅不能直接套用上表中的输出降幅。

Grok Imagine 的 Low、Medium、Auto 有什么区别

Low 的计算消耗和价格都较低，是旧 Quality 自动迁移时固定使用的档位。Medium 使用更多计算资源，面向更重视输出细节的任务。Auto 则由 xAI 决定质量，官方目前的规则是图像生成用 Low、图像编辑用 Medium，但这种映射未来可能调整。

最容易踩坑的情况是：把 model 改成 2.0，却没有填写 quality。

以 1 张参考图、1 张 1K 输出的编辑任务为例，旧 Quality 的理论费用是 0.06 美元。改用 2.0 后如果省略 quality，当前会走 Medium，费用变成 0.07 美元；继续使用旧标识走 Low，则是 0.05 美元。需要稳定预算时，建议始终显式填写质量档位。

另外，API 的 Low、Medium、Auto 不能直接等同于 Grok 网站上的 Fast、Quality 选项。文档、代码和产品说明中最好分开描述，避免给团队造成误解。

如何迁移到 Grok Imagine 2.0：参数、核查与 SDK 注意事项

推荐的迁移路径很简单：把 model 改为 grok-imagine-image-2.0，并按业务需要明确设置 quality。下面的官方接口示例来自 xAI 文档结构，需要替换真实密钥才能运行，本文未执行付费调用。

curl -X POST https://api.x.ai/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "A professional technology magazine cover",
    "quality": "low",
    "resolution": "1k",
    "aspect_ratio": "16:9",
    "n": 1
  }'

图像编辑可显式指定 Medium。下例中的图片地址只是占位符，需要换成你自己可访问的素材：

curl -X POST https://api.x.ai/v1/images/edits \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "Change the background to a clean white studio",
    "quality": "medium",
    "image": {
      "url": "https://example.com/input.jpg",
      "type": "image_url"
    }
  }'

如何确认 Grok Imagine 请求实际跑在 2.0 上

xAI 说明响应中的 model 字段会显示实际执行的模型，而不只是客户端请求时填写的别名。迁移时可以用旧标识发送一条测试请求，记录响应中的 model，再与对应账单核对。

xAI 还支持在 usage 中查看 cost_in_usd_ticks，用它除以 10000000000 即可换算为美元。这些是官方 API 的行为，第三方平台是否原样返回，需要单独核验。

Grok Imagine 编辑接口的 SDK 兼容性

文生图可以通过 OpenAI 兼容客户端调用，quality 这类扩展参数可放进 extra_body。图像编辑则要特别留意：OpenAI SDK 的 images.edit() 使用 multipart/form-data，而 xAI 编辑接口要求 application/json，所以不能直接复用。官方建议改用 xAI SDK、Vercel AI SDK，或符合要求的原生 HTTP 请求。

上线前还要检查以下工程细节：

• 图片保存：默认返回临时 URL，需要长期保留的素材应及时下载或转存，也可以请求 Base64 数据。
• 生成数量：n 支持 1 至 10，默认值为 1；默认分辨率为 1K。
• 编辑输入：最多可使用 5 张源图，并按张计算输入费。
• 速率限制：官方表格为 T0 每秒 6 次、T1 每秒 12 次、T2 每秒 25 次、T3 每秒 50 次、T4 每秒 100 次，实际额度以 xAI Console 为准。
• 批处理：模型页标注支持 Batch API，但批量价格显示 N/A，不要预设一定有折扣。

通过聚合平台调用 Grok Imagine 前先做校验

如果你通过聚合平台统一管理模型，建议先确认目标模型是否可用，再执行迁移。本文未能独立确认 API易 当前是否已上架 grok-imagine-image-2.0、是否支持全部质量参数及其实际售价，所以下面的代码会先做模型检查，不代表模型一定可用。

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"  # API易 OpenAI 兼容接口
)

target_model = "grok-imagine-image-2.0"
available_models = {model.id for model in client.models.list()}

if target_model not in available_models:
    raise SystemExit(f"{target_model} 当前不在可用模型列表中")

response = client.images.generate(
    model=target_model,
    prompt="A professional technology magazine cover",
    extra_body={"quality": "low"}
)

print("实际模型:", getattr(response, "model", "响应未返回"))
print("图片地址:", response.data[0].url)

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["IMAGE_API_KEY"],
    base_url=os.getenv("IMAGE_API_BASE_URL", "https://api.apiyi.com/v1"),
)

MODEL = "grok-imagine-image-2.0"
QUALITIES = ["low", "medium"]
PROMPTS = [
    "Product photo of a white ceramic mug on a clean studio background",
    "A tech conference poster with the title FUTURE API in large letters",
]


def run_regression():
    """用固定提示词对比质量档位，并记录实际模型和图片地址。"""
    for prompt in PROMPTS:
        for quality in QUALITIES:
            response = client.images.generate(
                model=MODEL,
                prompt=prompt,
                extra_body={"quality": quality},
            )
            print({
                "requested_model": MODEL,
                "actual_model": getattr(response, "model", "not_returned"),
                "quality": quality,
                "prompt": prompt[:30],
                "image_url": response.data[0].url,
            })


if __name__ == "__main__":
    run_regression()

迁移建议：可以先通过 API易 apiyi.com 核对模型列表和计费说明，再用小批量请求验证参数透传。新用户可使用免费测试额度完成这一步，模型未上架时不要直接切换生产流量。

Grok Imagine 2.0 迁移的影响分析

对开发者和产品团队的影响

这次迁移带来的第一个变化是模型版本不再“一眼可见”：调用成功并不说明旧模型仍在运行，日志中应同时记录请求模型和响应模型。第二个变化是预算要按路径测算，Low 和 Medium 在同分辨率下通常相差 0.02 美元，不能笼统地说 2.0 更便宜。第三个变化在产品验收层面，电商图、海报、人像和局部编辑都应使用固定样例回归。

Grok Imagine 2.0 的质量值得主动升级吗

目前可以确认的是执行模型切换到 2.0、迁移档位为 Low、对应输出单价下降，但这些事实不能证明所有图片都会变好。xAI 称 2.0 改进了多条件指令遵循、文字排版和图像编辑，并表示发布当日在 Arena 文生图和图像编辑榜单均排名第二，这只是 8 月 7 日的历史成绩。Arena 后续快照显示，它在 10 月 26 日文生图总榜排第 6，在 10 月 23 日单图编辑总榜排第 5。

独立测试同样要结合样本理解。Voyager 的 12 图样本中，单图耗时约 11 至 95 秒；ImageBench 的 192 项评估通过率约 79%，平均延迟 69 秒，但其自动判定可能出错。Reddit 上也有个别用户反馈皮肤过度平滑、局部修改波及整图等问题，不过这些主要是 8 至 9 月对消费级产品的体验，不能当作今天 API 重定向后的评价，也不能代表所有用户。

因此，排版、海报和多条件图片可以优先测试 2.0；人像写实、原图保留要求高的编辑任务，则应谨慎灰度。Arena 反映的是人类偏好，不等于你的业务合格率，最终仍要用自己的样本验证。

选择 Grok Imagine API 服务时看什么

通过第三方平台调用时，模型名称相同不等于上游路由和计费完全相同。xAI 官方价格也不等于任何第三方平台的实际售价，选型时建议逐项确认：

• 模型支持：是否提供 2.0，旧标识是否保留，实际路由到哪个模型。
• 参数兼容：quality、resolution、aspect_ratio 是否正确透传，编辑默认值是否清楚。
• 价格透明：输出费和参考图输入费如何计算，账单能否对应到单次请求。
• 迁移便利：切换模型时改动是否足够小，日志能否反映底层模型变化。

API易 apiyi.com 提供 OpenAI 兼容接口和一个 Key 调用多家模型的方式，适合用来对比和切换模型。具体到 Grok Imagine，仍应先按上述清单核实当前支持情况和价格。

Grok Imagine 迁移常见问题 FAQ

Grok Imagine 2.0 迁移核心要点 Key Takeaways

• 退役范围：今天退役的是 grok-imagine-image-quality 标识，不是 Grok Imagine 全线产品。
• 兼容情况：旧标识继续可用，实际固定由 2.0 Low 处理，1.0 不受影响。
• 价格变化：转到 Low 时每张输出便宜 0.01 美元，Medium 则比旧 Quality 贵 0.01 美元。
• 参数陷阱：2.0 省略 quality 时默认 Auto，当前编辑走 Medium，并不等同于旧标识路径。
• 验证方式：核查响应 model、请求账单和样例图片，不能只看接口是否返回成功。
• SDK 限制：OpenAI SDK 的 images.edit() 不能直接用于 xAI 编辑接口。
• 平台选择：可在 API易 apiyi.com 核对模型与计费后再做小批量测试，不把平台支持当作默认前提。

总结：Grok Imagine 旧标识退役后该怎么做

Grok Imagine 这次变化的重点不是服务停用，而是旧标识背后的模型换了。回到读者最关心的问题，结论可以归纳为三点：

1. 旧模型还能不能用：1.0 继续可用；旧 Quality 名称可继续调用，但实际运行的是 2.0 Low。
2. 代码要不要改：不是立刻必须改，但建议显式使用 grok-imagine-image-2.0 并填写 quality。
3. 成本怎么控制：批量任务优先测试 Low，细节要求高时再评估 Medium，编辑任务别漏算参考图费用。

下一步可以先排查配置中的旧标识，再用固定样本完成质量和账单回归。需要统一对比多个图像模型时，可以通过 API易 apiyi.com 查询当前可用模型，确认支持情况后再逐步切换流量。

📚 参考资料

1. xAI 迁移指南：11 月 2 日图像模型退役和重定向规则
2. 链接： docs.x.ai/developers/migration/imagine-image-quality-nov-2

3. 说明： 确认退役对象、2.0 Low 路由、1.0 不受影响及迁移方法

4. xAI Image 2.0 发布公告：2.0 的发布日期和官方能力说明

5. 链接： x.ai/news/grok-imagine-image-2

6. 说明： 可查看 8 月 7 日发布信息，其中的能力描述属于官方表述

7. xAI 开发者更新日志：Auto 默认值及 8 月更新记录

8. 链接： docs.x.ai/developers/release-notes

9. 说明： 用于确认 2.0 API 参数的时间线

10. xAI 官方价格表：图像输出和参考图输入价格

11. 链接： docs.x.ai/developers/pricing

12. 说明： 本文所有官方单价和理论成本的计算依据

13. xAI 图像生成文档：质量、分辨率、宽高比等参数说明

14. 链接： docs.x.ai/developers/model-capabilities/images/generation

15. 说明： 编写请求参数和核查响应时可查阅

16. xAI 图像编辑文档：编辑接口和 SDK 兼容性说明

17. 链接： docs.x.ai/developers/model-capabilities/images/editing

18. 说明： 确认 application/json 要求和 OpenAI SDK 限制

19. xAI 费用追踪与速率限制文档：单次费用和账户限额

20. 链接： docs.x.ai/developers/cost-tracking
21. 链接： docs.x.ai/developers/rate-limits

22. 说明： 适合核查单次请求费用和规划并发

23. Arena 榜单：注明日期的文生图和图像编辑排名快照

24. 链接： arena.ai/leaderboard/image/text-to-image
25. 链接： arena.ai/leaderboard/image/image-edit/single-image

26. 说明： 属于人类偏好评测，排名会随时间变化

27. 第三方测试：Voyager 和 ImageBench 的独立评估

28. 链接： voyager.so/resources/models/grok-imagine-2
29. 链接： imagebench.ai/imagebench-v1/xai--grok-imagine-2
30. 说明： 可作为任务表现参考，但不代表全平台平均水平

作者：API易 技术团队
技术交流：欢迎在 API易 apiyi.com 首页联系我们，更多资料可访问 docs.apiyi.com 文档中心

延伸阅读

• Kimi K3.1 Pro 相比上一代提升了什么？能力与价格对比:面向现有 K3 用户的升级对比：官方自报与 Artificial Analysis 两套数据分开解读，五档价格、单任务成本、迁移注意事项与“该换/不急”判断表一次讲清。
• 天呐！Krea 3，你要毁了 Nano Banana 吗？:Krea 3 做品牌广告图效果如何？本文用 5 步走完 Ad Studio 的官网→品牌 Kit→12 张静态广告流程，附官方效果图、成本表和 7 个坑。
• OpenAI、Anthropic、Google 一起清退旧模型：最早下个月就停，你在名单里吗:一页看全 OpenAI、Anthropic、Google 从 2026 年 11 月 17 日到 2027 年 4 月 1 日的 10 个下线节点：哪些型号受影响、替代型号是什么、会不会报错、代码改哪几行。