服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动，严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外，不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 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。
可结合AI API 配置指南与AI 接口错误排查指南区分模型字段、API 语义和连接层。
停手与回滚条件
当 auto 生成的质量低于验收线、费用波动不可解释、中间层没有透传参数、多图编辑结果不稳定或批量失败率上升时，应停止放量。回滚到显式 medium 或已验证配置，并保留 auto 的对照样本与账单证据。
若团队访问 xAI Console 或开发文档需要稳定连接，可访问 PuppyIP 官网了解固定网络出口。网络条件不会固定 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 结果波动超出验收线时，应显式固定并重新灰度。