Grok Imagine 官轉生圖

概述

Grok Imagine 官轉是 xAI 影像模型的官方通道：請求經 API易轉發到 xAI 官方 API，價格與 xAI 官網一致，按解析度與畫質檔計費，引數校驗也與官方一致。本通道提供三個型號：標準版 grok-imagine-image、高品質版 grok-imagine-image-quality，以及新一代 grok-imagine-image-2.0（支援 low / medium 兩檔畫質）。

🔒 本通道需申請開通 GrokOfficial 分組Grok Imagine 官轉不在 Default 預設分組。該系列的內容安全策略與平臺其它模型差異較大，為避免合規風險我們採取定向開放：

累計消費滿 $1,000 的存量客戶：聯絡客服說明用途，核驗後開通
其他客戶：通過企業微信客服提交申請，說明使用場景與內容管控措施，稽核通過後為你單獨開通

令牌分組不含 GrokOfficial 時呼叫會返回 503，這是權限問題、不是服務故障。詳見下方分組介紹。

官轉還是官逆？ 本頁是官轉：與官網同價、按檔計費、含 grok-imagine-image-2.0，當前只開放文生圖且每次 1 張。如果你需要圖片編輯、單次多張，或更低的按次固定價（$0.02 / $0.045 一張、不區分解析度），請用 Grok Imagine 官逆。兩者對比見官轉與官逆怎麼選。

圖片 API 全部為同步呼叫：沒有非同步任務 ID，客戶端斷開連線結果即丟失、但請求仍會計費。grok-imagine-image-2.0 的 medium 檔 2K 出圖實測約 60–80 秒，請為本模型設定足夠大的 timeout，詳見圖片 API 呼叫須知與最佳實踐。

文生圖 API

輸入文本提示詞生成圖片，帶互動式 Playground 線上除錯。

Grok Imagine 影片生成

同一個 GrokOfficial 分組，文生影片 / 圖生影片，按秒計費。

讓 AI Agent 幫你接入

複製這段提示詞，貼上給 Codex / Claude Code / Cursor

它會先抓本頁的純文本版（任意文件頁地址後加 .md），再按你專案的技術棧寫程式碼——超時、URL 結果要立即轉存、size 不生效要改用 resolution、每次只出 1 張這幾個高頻坑已經寫死在要求裡。

幫我在當前專案裡接入 / 排查 Grok Imagine 官轉的「文生圖」。

先讀文件再動手：抓 https://docs.apiyi.com/api-capabilities/grok-imagine-image-official/overview.md 拿到本頁純文本版； …

模型名三選一：grok-imagine-image、grok-imagine-image-quality、grok-imagine-image-2.0 …

共 8 條接入要求，點下方按鈕複製完整版

模型與定價

價格與 xAI 官網一致，按每張圖計費，檔位由 resolution（與 2.0 的 quality）決定：

模型	畫質檔	`1k`	`1.5k`	`2k`
`grok-imagine-image`	—	$0.02	$0.02	$0.02
`grok-imagine-image-quality`	—	$0.05	$0.06	$0.07
`grok-imagine-image-2.0`	`low`（預設）	$0.04	$0.05	$0.06
`grok-imagine-image-2.0`	`medium`	$0.06	$0.07	$0.08

模型價格與官網對齊，且可能隨官網調整；上表僅供參考，具體以頂部導航「模型價格」欄目為準：模型價格。

計費說明

不傳引數時：預設 resolution: 1k；grok-imagine-image-2.0 預設 quality: low，即 $0.04 一張。
按張計費、每次 1 張：本通道請固定 n=1，需要多張請併發呼叫。
請求失敗不計費：引數錯誤（422 / 400）、分組無權限（503）等返回錯誤的請求不扣費。
響應體裡的 usage 不能用來核賬：prompt_tokens 恆為 1000 × 張數，是佔位值，真實扣費以控制台賬單為準。
可疊加充值階梯加贈；用量較大的企業客戶可聯絡商務溝通專屬價格。

官轉與官逆怎麼選

API易同時提供 Grok Imagine 的官轉與官逆兩條通道，分組、計費方式和能力都不同：

維度	官轉（本頁）	官逆
分組	`GrokOfficial`（需申請）	`Grok_imagine_Reverse`（需申請）
計費	與官網同價，按解析度 × 畫質檔按量計費	按次固定價，不區分解析度
型號	`grok-imagine-image` / `-quality` / `-2.0`	`grok-imagine-image` / `-quality`
解析度檔	`1k` / `1.5k` / `2k`	`1k` / `2k`
文生圖	✅	✅
圖片編輯 / 多圖融合	暫不開放	✅ 1–4 張參考圖
單次多張	暫不開放（`n=1`）	✅ `n` 最多 10
引數校驗	嚴格：列舉外的值返回 422	寬鬆：非法值靜默回退預設值

怎麼選：要 grok-imagine-image-2.0、要按官方口徑對賬、或希望引數寫錯就報錯 → 官轉。要圖片編輯、單次多張，或者只出 2K 想要更低單價 → 官逆。兩個分組可以同時開通，用不同令牌分別呼叫。

分組介紹

Grok Imagine 官轉不在 Default 預設分組。 本通道放在 GrokOfficial 專屬分組（與官網同價，即上方定價表），需申請開通後才能呼叫。

誰可以開通

客戶型別	開通方式
累計消費滿 $1,000 的存量客戶	聯絡客服說明用途，核驗後開通
其他客戶	提交申請，說明使用場景與內容管控措施，稽核通過後單獨開通

怎麼申請

聯絡企業微信客服

通過企業微信客服提交申請，也可發郵件到 [email protected]。註明申請的是 GrokOfficial（Grok Imagine 官轉）。

說明使用場景與內容管控措施

請寫清楚三件事：出圖用於什麼業務、面向什麼終端使用者、你這一側有哪些內容稽核與人工複核措施。資訊越具體，稽核越快。

開通後切換令牌分組

稽核通過後我們為你的賬號開通 GrokOfficial 分組。請到控制台令牌頁把呼叫本通道的令牌分組切到 GrokOfficial，計費模式選 按量優先 或 按量計費。

未開通時的表現：令牌分組不含 GrokOfficial 時呼叫返回 503（當前分組無可用渠道），重試無效，需要先完成開通。令牌「計費模式」不要選 按次計費：本通道是按量計費，按次計費的令牌路由不到，同樣會返回 503。

合規提醒：開通後生成內容的合規責任在呼叫方。請遵守當地法律法規，不得用於生成違法內容、侵犯他人肖像權與智慧財產權的內容，或面向未成年人的不當內容；面向 C 端分發的場景建議在你這一側再加一層稽核。相關背景見國內產品呼叫海外模型的合規要點。發現濫用我們會收回該分組權限。

技術規格

專案	規格
模型 ID	`grok-imagine-image`、`grok-imagine-image-quality`、`grok-imagine-image-2.0`
端點	`POST /v1/images/generations`（`application/json`）
解析度檔位	`1k`（預設）/ `1.5k` / `2k`
寬高比	常用 `1:1`（預設）/ `16:9` / `9:16` / `4:3` / `3:4` / `3:2` / `2:3`
畫質檔	僅 `grok-imagine-image-2.0`：`low`（預設）/ `medium`
單次張數	`n=1`
返回格式	`url`（預設）或 `b64_json`
引數校驗	嚴格，列舉外的 `resolution` / `aspect_ratio` 返回 422
出圖耗時	`grok-imagine-image` 約 8 秒；`-quality` 1k 約 7 秒、2k 約 12 秒；`-2.0` `low` 約 15–17 秒、`medium` 2K 約 60–80 秒
建議客戶端超時	≥ 360 秒

關鍵引數詳解

`resolution` 與 `aspect_ratio`（輸出尺寸）

兩個引數組合決定輸出畫素。部分實測值：

模型	請求	實際輸出
`grok-imagine-image`	`1k` + `3:2`	1248×832（JPEG）
`grok-imagine-image-quality`	`2k` + `9:16`	1584×2816（PNG，約 6.7 MB）
`grok-imagine-image-2.0`	`1.5k` + `16:9` + `medium`	1792×1008

不要傳 size，用 resolution本通道不會把 OpenAI 風格的 size（如 "2048x2048"）換算成解析度檔：傳了 size 不報錯，但會按預設 1k 出圖、按 1k 計費。需要 2K 請顯式傳 resolution: "2k"。

引數寫錯會直接報錯：與官逆通道不同，本通道的引數校驗與 xAI 官方一致。resolution: "4k"、aspect_ratio: "5:7" 這類列舉外的值會返回 422，請求不計費。看到 422 時先檢查這兩個引數的拼寫（注意都是小寫 1k / 1.5k / 2k）。

`quality`（僅 `grok-imagine-image-2.0`）

值	說明
`low`	預設檔，速度較快
`medium`	畫質更高、單價高 $0.02，2K 出圖約 60–80 秒

傳 high 會返回 400（This model only supports the following quality value(s): low, medium, auto）。請只傳 low 或 medium，不要傳 auto。grok-imagine-image 與 grok-imagine-image-quality 不需要傳 quality，畫質由模型本身決定。

`n`（張數）

本通道固定傳 n=1。需要一次拿多張圖，請併發發起多次請求——本通道的出圖耗時穩定，併發呼叫即可線性提速。

最佳實踐

先用 1k 定稿，再出 2k

同一個提示詞先用 1k 跑幾次挑方向，滿意後再用 2k 出終稿。grok-imagine-image-2.0 的 medium 檔 2K 出圖要 1 分鐘以上，不適合拿來試錯。

客戶端超時設到 360 秒

圖片 API 是同步呼叫，按 60 秒配置會在 2.0 medium 檔產生大量誤超時，而被掐斷的請求仍然計費。

用 aspect_ratio 控制構圖，不要寫進提示詞

引數是真實生效的，直接傳 aspect_ratio: "16:9" 比在提示詞裡寫「橫版構圖」可靠。

URL 結果立即轉存

返回的圖片連結請在服務端立即下載到自己的儲存，不要長期引用，也不要直接下發給終端使用者。

需要編輯時換官逆通道

本通道暫不開放圖片編輯。基於參考圖改圖、多圖融合請用 Grok Imagine 官逆的 /v1/images/edits。

錯誤碼與重試

HTTP	含義	處理建議
`400`	`quality` 取值非法（如 `high`），錯誤資訊會列出合法值	改為 `low` / `medium`，不要重試
`422`	`resolution` / `aspect_ratio` 不在支援的列舉內	檢查拼寫與大小寫，不要重試
`429`	頻率超限或額度不足	指數退避重試，並檢查賬戶餘額
`503`	令牌未開通 `GrokOfficial` 分組，或令牌計費模式為按次計費	權限問題不是故障，重試無效，先按分組介紹處理

客戶端建議：400 / 422 是確定性錯誤，重試沒有意義，應直接告警。只有 429 和網路層超時值得重試，建議指數退避、最多 3 次。返回錯誤的請求不計費。

常見問題

呼叫一直返回 503，是渠道掛了嗎？

基本是權限問題，有兩種可能：

令牌分組不含 GrokOfficial：本通道需申請開通，見分組介紹。
令牌計費模式是「按次計費」：本通道按量計費，按次令牌路由不到。把計費模式改成 按量優先 或 按量計費 即可。

為什麼傳了 size: 2048x2048 出來還是 1K？

本通道不把 size 換算成解析度檔，傳了也按預設 1k 出圖和計費。請改用 resolution: "2k"，構圖比例用 aspect_ratio 控制。

能做圖片編輯、傳參考圖嗎？

本通道暫不開放圖片編輯。往 /v1/images/generations 傳參考圖不會報錯，但參考圖會被忽略，只按提示詞出一張新圖。需要編輯或多圖融合，請開通並使用 Grok Imagine 官逆，它的 /v1/images/edits 支援 1–4 張參考圖。

為什麼要求 n=1？一次出多張怎麼辦？

本通道當前只開放單張出圖。需要多張請併發發起多次請求，每次 n=1。如果你的業務確實依賴單次多張，可以使用 Grok Imagine 官逆（n 最多 10）。

grok-imagine-image-2.0 和另外兩款有什麼區別？

grok-imagine-image-2.0 是 xAI 新一代影像模型，多了 quality（low / medium）畫質檔，medium 檔細節更好但更慢（2K 約 60–80 秒）。grok-imagine-image 最便宜、各解析度同價；grok-imagine-image-quality 畫質更高，按解析度階梯計價。建議先用 grok-imagine-image 或 2.0 low 跑通流程，再按畫質需求升檔。

usage 裡的 token 數能用來核對賬單嗎？

不能。 響應體的 usage.prompt_tokens 恆為 1000 × 張數，是佔位值，與實際計費無關。本通道按張、按解析度與畫質檔計費，真實扣費以控制台賬單為準。

能用 OpenAI 官方 SDK 呼叫嗎？

可以。端點相容 OpenAI Images API，把 base_url 指向 https://api.apiyi.com/v1，非標準欄位放進 extra_body：

from openai import OpenAI
client = OpenAI(api_key="sk-your-api-key", base_url="https://api.apiyi.com/v1")

resp = client.images.generate(
    model="grok-imagine-image-2.0",
    prompt="a red wooden boat on an alpine lake at dawn",
    n=1,
    extra_body={"resolution": "2k", "aspect_ratio": "16:9", "quality": "medium"},
    timeout=360,
)
print(resp.data[0].url)

產品基礎

基礎 API

圖片 API（官轉）

影片 API（官轉）

多模態理解 API

文本生成

音訊 API（官轉）

檢索與安全

概述

文生圖 API

Grok Imagine 影片生成

讓 AI Agent 幫你接入

模型與定價

官轉與官逆怎麼選

分組介紹

誰可以開通

怎麼申請

技術規格

關鍵引數詳解

`resolution` 與 `aspect_ratio`（輸出尺寸）

`quality`（僅 `grok-imagine-image-2.0`）

`n`（張數）

最佳實踐

錯誤碼與重試

常見問題

相關文件

​概述

文生圖 API

Grok Imagine 影片生成

​讓 AI Agent 幫你接入

​模型與定價

​官轉與官逆怎麼選

​分組介紹

​誰可以開通

​怎麼申請

​技術規格

​關鍵引數詳解

​resolution 與 aspect_ratio（輸出尺寸）

​quality（僅 grok-imagine-image-2.0）

​n（張數）

​最佳實踐

​錯誤碼與重試

​常見問題

​相關文件

概述

讓 AI Agent 幫你接入

模型與定價

官轉與官逆怎麼選

分組介紹

誰可以開通

怎麼申請

技術規格

關鍵引數詳解

`resolution` 與 `aspect_ratio`（輸出尺寸）

`quality`（僅 `grok-imagine-image-2.0`）

`n`（張數）

最佳實踐

錯誤碼與重試

常見問題

相關文件