Grok API 適用的 Imagine Image 2.0

使用 grok-imagine-image-2.0 建立文字轉圖片與圖片編輯工作流程。xAI API 透過與 OpenAI 相容的圖片端點,支援可設定的畫面比例、解析度、輸出數量與回應格式。
建立 xAI API 金鑰
電影感抽象圖片生成場景,帶有發光玻璃雕塑與自然攝影棚燈光

選擇合適的 Grok 圖片工作流程

細節豐富且連貫的奇幻風景,示範由提示詞驅動的圖片生成
參考圖片引導的圖片編輯工作流程
生成圖片資產的正式環境整合
在傳送正式環境請求之前,驗證媒體輸入與輸出設定。

Grok Imagine Image 2.0 API 功能

專用圖片模型

將 <code>model</code> 設為 <code>grok-imagine-image-2.0</code>,以進行目前的 Imagine Image 2.0 生成與編輯。

文字轉圖片生成

傳送提示詞到 <code>/v1/images/generations</code>,並在單一呼叫中請求最多 10 張生成的圖片。

可設定的輸出

選擇畫面比例、1K 或 2K 解析度、輸出數量,以及支援的回應格式。

圖片編輯

將編輯指令與公開圖片 URL 或 base64 編碼的資料 URI 傳送到 <code>/v1/images/edits</code>。

最多三個編輯參考

多圖片編輯最多接受三張來源圖片,用於構圖、主體組合與風格引導。

Bearer 驗證

在 <code>Authorization</code> 標頭中傳送 xAI API 金鑰,並確保憑證不會出現在瀏覽器程式碼、日誌與儲存庫中。
xAI 採用固定每張影像計價,解析度與品質會影響輸出費用。

Grok API 的 Imagine Image 2.0 價格

生成輸出定價

xAI 目前將 Imagine Image 2.0 的輸出定價列為:1K Low 每張圖片 $0.04、2K Low $0.06、1K Medium $0.06、2K Medium $0.08。

媒體輸入定價

Imagine Image 2.0 路由的圖片輸入定價為每張輸入圖片 $0.01;因此編輯請求會包含輸入圖片與生成輸出的費用。

提示詞長度不會決定圖片費用

圖片生成採用每張圖片固定定價,而非以 token 計算的提示詞計費。將你請求的圖片數量乘以所選的輸出等級,再加上任何編輯的圖片輸入費用。

重新確認即時價格

正式部署前請查看目前的 xAI 價格頁面,因為模型層級與計費條款可能變更。

整合 Grok Image API

1. 建立並妥善保管 API 金鑰
1

1. 建立並妥善保管 API 金鑰

在 xAI 主控台建立金鑰,並以 Authorization: Bearer $XAI_API_KEY 傳送。請將金鑰保存在伺服器端。
2. 選擇生成或編輯
2

2. 選擇生成或編輯

僅使用提示詞建立時,用 /v1/images/generations。當來源影像需要引導或轉換時,用 /v1/images/edits
3. 建立通過驗證的請求
3

3. 建立通過驗證的請求

model 設為 grok-imagine-image-2.0,加入提示詞,並明確只選擇你的產品支援的輸出選項。
4. 提交並檢查回應
4

4. 提交並檢查回應

保存回傳的 URL 或 base64 資料前,先檢查 HTTP 狀態與回應主體。不要假設每個回應都包含可用影像。
5. 刻意下載並保留資產
5

5. 刻意下載並保留資產

若需要長期可用性,請將完成的資產複製到你自己的核准儲存空間,並以冪等方式處理重試,避免重複扣款。
當可重複的提示詞與編輯工作流程比手動影像編輯器更重要時,使用此 API。

開發者使用 Grok Imagine Image 2.0 建立什麼

行銷活動的創意變體

從結構化提示詞範本,為廣告、登陸頁與社群行銷活動生成多種視覺方向。

產品與概念視覺化

將產品簡報、環境描述與美術指導,轉化為可審查的影像概念。

參考影像引導的編輯

使用自然語言指令轉換已核准的來源影像,同時在工作流程中保留原始資產。

在地化視覺製作

針對地區、格式與管道調整提示詞細節,同時保持請求驗證與資產追蹤的一致性。
端點、定價、模型識別、影像輸入,以及平台關係。

Grok API 常見問題

開始整合 Grok 影像 API

Grok API:Imagine Image 2.0 指南與定價 | GoEnhance Open API