Grok旧图片模型11月2日退役怎么迁移？模型名、quality与结果验收

图片接口还能返回成功，不一定说明模型没有变化。xAI公告明确，grok-imagine-image-quality将于2026年11月2日退役，旧名称继续解析，但请求会由新模型的低质量档处理。本教程适用于维护现有出图脚本的人，先盘点旧调用，再显式迁移并验收，不把自动重定向误认为完全保持旧行为。

第一步：确认受影响的模型与日期

官方说明通知期从2026年9月2日开始，11月2日起，/v1/images/generations与/v1/images/edits中的旧模型名将指向grok-imagine-image-2.0，quality设为low。文章核对日期为10月26日，这仍是即将生效的变化，不能把它写成已经全部完成。

grok-imagine-image这个1.0名称不受本次变化影响；grok-imagine-image-pro原先已重定向到quality，也会继续跟随本次迁移。先在自己的配置、任务模板和部署环境中搜索准确旧名称，区分实际使用的入口，不因名字相似就把所有图像脚本一起改掉。

第二步：备份配置并固定验收样本

保存受影响的模型配置与脚本版本，记录生成还是编辑、图片数量、尺寸、比例以及输出处理方式。准备少量有使用权的固定提示词，覆盖文字、主体细节与常用构图；编辑请求还需保留相同来源图。不要在改模型同时改全部提示词，否则很难解释输出差异。

迁移清单：调用位置；原模型名；生成或编辑端点；是否显式quality；图片数量和尺寸；响应解析字段；成本记录位置；回退配置。先逐项填写实际值，缺失项写待查，不凭默认印象补齐。

第三步：显式改为新模型并选择质量

官方建议在退役日前明确使用grok-imagine-image-2.0。quality支持low、medium与auto；当前auto在生成中使用low、编辑中使用medium，并按实际档位计费。若想使成本选择清楚，应显式填写quality，而不是只改model后继续依赖默认。

import os
import json
import requests

response = requests.post(
    "https://api.x.ai/v1/images/generations",
    headers={"Authorization": "Bearer " + os.environ["XAI_API_KEY"]},
    json={
        "model": "grok-imagine-image-2.0",
        "quality": "low",
        "prompt": "原创水彩插画：清晨的灯塔、柔和海雾、简洁构图，不含文字与标志",
        "n": 1,
    },
    timeout=180,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))

这是独立API示例，需要自己的xAI权限、密钥和额度；本文未执行付费调用。编辑请求同样要检查模型名与质量，但不能直接把生成端点的示例当成编辑请求，来源图结构应沿用官方编辑文档支持的格式。

第四步：核对返回模型、输出与账单

官方说明响应中的model字段报告实际处理模型，可在日志中确认重定向或显式迁移结果。记录状态、实际模型和选用参数即可，避免把密钥与私有来源图写入日志。再按真实响应格式打开输出图片，检查尺寸、主体、文字和编辑保留区域。

固定提示词不代表新旧模型会生成相同像素，应按业务标准验收：主体能否辨认、指定内容是否保留、文本是否正确、输出是否满足渠道要求。价格按当前官方计费与实际质量档核对，不把“低档”理解为免费，也不套用聊天平台会员权益。

第五步：逐步替换并检查遗留调用

先在小样本验证解析和文件保存流程，再更新正式配置，检查定时任务、旧服务和备用环境是否仍发旧名称。官方说请求与响应形状保持不变，但自己的代码仍可能依赖某个模型字符串或固定结果，应实测这些分支。

保留可恢复的配置版本与验收记录；退役后回到旧名称也会被重定向，不能将它当成恢复原模型的回退办法。完成标准是受影响调用已盘点、新模型与质量选择明确、响应和图片处理正常、成本可查，并知道哪些旧名称仍在依赖自动转发。

官方资料

资料核对日期：2026年10月26日。

• xAI：旧图片模型2026年11月2日退役说明
• xAI：图像生成的质量与参数