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 個下線節點：哪些型號受影響、替代型號是什麼、會不會報錯、代碼改哪幾行。