本文要点
- xAI 2026 年 8 月 28 日更新 Imagine Image API，quality 新增 auto，省略参数时默认从 medium 变为 auto。
- 当前 auto 在图片生成使用 low，在图片编辑使用 medium；服务方可以调整 auto 路由，不能把当前行为写死为永久合同。
- 图片按实际提供的质量计费；需要稳定质量或可预测预算时应显式传 low 或 medium。
- 编辑请求最多支持 5 张参考图，原先为 3 张；同时新增 21:9 与 5:2 画幅。
- 先对批量生成与编辑分别回放，再决定是否固定质量；不要只看一次图片主观效果。
发生了什么：省略参数不再等于 medium
xAI release notes 明确写明，grok-imagine-image-2.0 的 quality 接受 low、medium 和 auto，省略 quality 的默认值已从 medium 改为 auto。当前 auto 对纯生成选择 low，对编辑选择 medium，并按实际提供的质量计费。
典型症状是代码没改，批量生成的成本或画面细节却发生变化。错误直觉是先怀疑提示词、随机种子或网络；正确第一步是从请求日志确认 quality 是否被省略，并记录响应的实际用量与成本字段。
auto、low、medium 应该怎么理解
auto 把质量选择交给服务端，适合愿意接受路由变化的工作负载；low 适合草图、高吞吐预览和成本敏感任务；medium 适合需要更稳定细节的最终产物。这里的适用场景是工程决策，不是质量承诺，仍需用自己的素材验证。
如果预算或视觉验收依赖固定档位，显式传 low 或 medium。不要把当前 auto 对生成使用 low 的实现写成永久假设，因为官方用词是 currently。
生成与编辑必须分开回归
同一个 auto 在生成和编辑上的当前选择不同。分别准备文本生成与参考图编辑样本，固定提示、分辨率、画幅和输出数量，比较细节、文字、主体一致性、耗时、失败率与实际费用。
编辑最多可带 5 张参考图，原先为 3 张。增加参考图会扩大输入、失败和费用边界；不要因为上限提高就默认把所有素材一次发送，也不要把多图顺序的语义交给偶然结果。
画幅、分辨率与输出数量一起检查
本次还新增 21:9 与 5:2 画幅。图片生成文档说明 aspect_ratio 省略时默认为 auto，resolution 省略时默认为 1k，n 默认为 1；这些默认与 quality 是不同参数，排错时要分别记录。
批量生成时总费用还受输出数量、分辨率和实际质量影响。不要把单张 low 的成本外推到 n=10、2k 或多参考图编辑；应读取每次响应的 usage 与 cost 字段并同账单核对。
从发现隐式默认到灰度的六步
依次执行：搜索缺失 quality 的调用；按生成和编辑分组；建立旧产物与费用基线；显式测试 auto、low、medium；按任务类型写入配置；小比例灰度并观察账单。客户端 SDK 或 OpenAI 兼容层可能不直接暴露扩展字段，要验证实际请求体。
配置变更应支持按任务回滚，不要把一个全局默认同时应用到草图、商品图和编辑流程。若中间层删除 quality，应在适配器层记录并测试，而不是误以为显式配置已经送达 xAI。
报错、费用异常与网络问题怎么分层
400 通常先检查模型、endpoint、quality、resolution、aspect_ratio 和参考图数量；429 检查配额；费用异常核对实际质量与输出数量；只有 DNS、TLS、连接超时或代理认证证据出现时才查网络。保存 request ID、请求体摘要和响应 usage。
可结合<a href="/resources/ai-api-key-base-url-model-guide">AI API 配置指南</a>与<a href="/resources/ai-relay-error-troubleshooting-guide">AI 接口错误排查指南</a>区分模型字段、API 语义和连接层。
停手与回滚条件
当 auto 生成的质量低于验收线、费用波动不可解释、中间层没有透传参数、多图编辑结果不稳定或批量失败率上升时，应停止放量。回滚到显式 medium 或已验证配置，并保留 auto 的对照样本与账单证据。
若团队访问 xAI Console 或开发文档需要稳定连接，可<a href="/" target="_blank" rel="noopener noreferrer">访问 PuppyIP 官网</a>了解固定网络出口。网络条件不会固定 auto 路由，也不能改变质量档位、配额或计费规则。
资料来源
常见问题
Grok Imagine 2.0 省略 quality 时是什么默认值？
现在默认是 auto，不再是 medium。官方当前说明 auto 对生成使用 low，对编辑使用 medium。
auto 的生成质量会永远固定为 low 吗？
不能这样假设。官方使用 currently 描述当前路由；需要稳定行为时应显式传 low 或 medium。
auto 模式怎么计费？
图片按实际提供的质量计费。应读取响应 usage、cost 字段和账单，不要只按请求中的 auto 估算。
编辑请求最多能放几张参考图？
本次更新后最多 5 张，之前为 3 张。仍需验证顺序、输入费用和具体编辑效果。
新增了哪些画幅？
本次新增 21:9 和 5:2；完整支持列表与默认行为应以最新图片生成文档为准。
什么时候应该显式固定 medium？
最终产物有稳定细节要求、预算模型依赖固定档位，或 auto 结果波动超出验收线时，应显式固定并重新灰度。