根据 xAI 官方开发者迁移文档记录，grok-imagine-image-quality 模型别名将于 2026 年 11 月 2 日正式从 xAI API 中退役。该项变动的 60 天通知期始于 2026 年 9 月 2 日。临近生效日，依赖该接口调用的开发者与自动化流水线运维人员，需重点关注切换后的服务承接逻辑、输出画质与计费变动。
在信息核实层面，本事件属于官方已确认（confirmed）的技术更迭。官方迁移文档仅明确针对 xAI API 的模型别名退役与请求承接进行说明，未包含网页端、X 应用端或相关客户端订阅产品受影响的确认。讨论应严格限定在 API 开发者调用层面，不应将其外推至未获确认的场景。此外，官方文档仅注明 2026 年 11 月 2 日这一生效日期，未公布具体的生效时区或精确切换时刻。
旧别名保留解析，但底层服务发生改变
第三方平台下线模型往往意味着路由失效或请求报错，但 xAI 此次采取了平滑过渡的重定向策略。自 2026 年 11 月 2 日起，系统底层行为将产生以下四项核心变化：
- 旧模型标识继续解析：发送至
grok-imagine-image-quality的请求不会中断，现有业务代码不会因未改名而遭遇路由不存在或系统报错。 - 底层承接模型切换：旧别名接收到的调用请求，将统一由
grok-imagine-image-2.0在底层承接并提供服务。 - 默认输出质量锁定为 low：通过旧别名重定向的请求，画面质量参数将被系统默认强制设为
low。若既有业务对细节要求较高，不调整调用的情况下可能出现明显的画质降级。 - 基础版本不受波及：文档明确注明，
grok-imagine-image（即 1.0 版本）不受此次退役影响，其既有调用方式保持不变。
请求兼容性与 2.0 新参数支持
在协议与数据格式上，xAI 官方表示请求与响应的整体结构（request and response shapes）保持完全一致。旧接口所能接收的每一个参数，在 11 月 2 日切换之后依然能够被新系统正常接收与处理，开发者无需重写入参结构。
负责承接请求的新模型 grok-imagine-image-2.0 具备以下功能与计费特征：
- 功能覆盖与计费变动影响：官方文档指出，
grok-imagine-image-2.0已经覆盖了过去grok-imagine-image-quality所承担的全部使用场景。在计费影响（Pricing impact）方面，新模型的定价方式与旧模型不同，其中grok-imagine-image-2.0在low质量档位下每张图相比原模型便宜 0.01 美元；切换生效后，通过旧别名重定向的请求将统一按照low费率计费。 - 支持显式质量参数：新模型新增对
quality参数的支持，允许调用方根据业务需求主动指定质量档位，避免被动接受重定向默认的low档。 - 多图编辑与新画幅比例：在图像编辑场景下，新模型支持传入最多 5 张参考源图（up to five source images for editing）；构图比例上，额外增加了
21:9与5:2两种超宽画幅选项。
对于提示词编写与画面效果细节，可参考Grok 图像生成与编辑功能指南了解不同画幅与指令的设计方法。
开发者应对建议：显式迁移而非依赖重定向
虽然旧别名自动重定向机制避免了服务硬性中断，但官方仍明确建议在 11 月 2 日到来前，主动将代码中的请求模型显式修改为 grok-imagine-image-2.0。
显式迁移的核心价值包括：
- 拿回画质控制权：重定向会导致质量被默认锁定在
low档位。主动声明新模型并传入所需的quality参数，业务系统才能按需获取高质量图像，保障用户体验。 - 精准控制 API 支出：虽然重定向请求按便宜 0.01 美元的
low费率计费，但业务若需更高画质，显式调用新模型并指定质量档位有助于团队在财务预算、日志统计与成本归因中建立精确对齐。成本核算与编排思路可参考Grok API 成本核算与工作流设置。 - 检验日志与元数据兼容：底层模型变更可能会反映在响应元数据或模型标识字段中。提前在测试环境显式调用，有助于验证下游数据处理管道是否存在对字段名称的硬编码依赖。
若团队在评估接口集成的同时需要配置相关账号或充值测试额度，可查看 PayForChat Grok 专区 了解更多订阅与额度获取方式。
官方来源与核实说明
- 核实来源：xAI 官方开发者迁移专页（
https://docs.x.ai/developers/migration/imagine-image-quality-nov-2） - 核实日期：2026 年 10 月 19 日
- 适用限制与未证实事项：
- 该文档全部内容仅针对 xAI API 平台及其模型别名机制，未包含网页端、X 应用或其他客户端订阅权益是否受影响的说明与确认。
- 计费方面，官方明确指出
grok-imagine-image-2.0 low每张图相比原模型便宜 0.01 美元，重定向请求按low费率计费；文档未进一步披露其他质量档位的具体单价。 - 官方文档未标明 11 月 2 日切换的具体时区及精确时间点，开发者应提前完成代码更新并以网关实际响应为准。
常见问题解答
Q: grok-imagine-image-quality 在 11 月 2 日后会直接返回错误代码吗？
A: 不会。官方说明该 slug 会继续保持解析，请求与响应结构均保持兼容，接口不会因为旧别名退役而直接报错。
Q: 为什么官方建议在 11 月 2 日前主动切换到 grok-imagine-image-2.0？
A: 因为重定向请求会被系统默认强制指定为 low 质量。显式调用新模型可自主传递 quality 参数，灵活平衡画面清晰度与支出。
Q: grok-imagine-image 1.0 模型会受到本次切换的影响吗？
A: 不受影响。官方文档明确注明 grok-imagine-image（1.0）保持正常运行，本次调整仅涉及带有 quality 后缀的别名。
Q: grok-imagine-image-2.0 相比旧模型增加了哪些功能参数？
A: 新模型在完全兼容既有参数的基础上，新增了 quality 质量参数，编辑场景支持最多 5 张参考源图，并新增 21:9 与 5:2 两种画幅比例。
Q: 本次迁移文档是否确认了对网页端或客户端订阅的影响？
A: 没有。官方迁移文档仅针对 xAI API 模型别名机制，未提供任何关于网页端或 X 客户端等订阅权益的变更确认。
Q: 官方文档是否给出了 11 月 2 日切换的具体时区或精确时间点？
A: 没有。官方迁移专页仅注明生效日期为 2026 年 11 月 2 日，未公布具体时区或切流时刻，建议开发者提前完成代码更新。