用於生成與編輯的 Grok Image API
透過獨立的 GoEnhance API 使用 Grok Image。可以從文字提示詞生成,也可以提供最多九張參考圖進行圖生圖編輯,再以輪詢或 HTTPS 回呼取得非同步結果。GoEnhance 不是 xAI,此介面也不是 xAI 官方 API。
建立 API Key
一個端點同時支援新圖生成與參考圖編輯
文字生成圖像
將 model 設為 grok-image,傳入 1–2,000 個字元的提示詞,並選擇 2:3、3:2、1:1、9:16 或 16:9。此長寬比僅對純文字請求生效。

參考圖編輯
在 image_list 中加入 1 到 9 個可存取的圖片網址,即可執行圖生圖生成。有參考圖時,文件中的長寬比欄位會被忽略。

只使用文件中列出的請求欄位,並在送出前完成驗證。
Grok Image API 功能
統一的圖像端點
向 <code>https://api.goenhance.ai/api/v1/images/generations</code> 送出 JSON POST 請求。
精確指定模型
將必填的 <code>model</code> 值設為 <code>grok-image</code>。
提示詞驗證
必須提供文字提示詞,長度介於 1 到 2,000 個字元之間。
選用的參考圖
圖生圖請求可在 <code>image_list</code> 中提供 1 到 9 個網址物件。
純文字請求的長寬比
未提供參考圖清單時,可選擇 2:3、3:2、1:1、9:16 或 16:9。
非同步結果處理
保存 <code>img_uuid</code>,接著輪詢任務詳情或處理 HTTPS 回呼事件。
目前的 GoEnhance 文件對每張生成圖片列出固定費率。
Grok Image API 價格
每張圖 1.3 點數
文件記載每次成功的 Grok Image 生成會消耗 1.3 個 GoEnhance 點數。
每張圖 $0.026
文件記載的美元等值價格為每張生成圖片 $0.026。
處理餘額相關回應
除了 HTTP 狀態碼,也要檢查 JSON 回應中的 code;點數不足時可能回傳 <code>code: 100</code>。
四個步驟介接 Grok Image API
1
1. 建立 API Key
建立 GoEnhance Key,並在伺服器端的
Authorization 標頭中傳送。 2
2. 組出請求
以
model: grok-image 發出 POST 請求並附上提示詞。要做參考圖編輯就加上 image_list,要做文字生成圖像則選擇支援的長寬比。 3
3. 追蹤任務並讀取結果
從成功回應中讀取
data.img_uuid,並與你自己的任務紀錄關聯。接著輪詢 GET /api/v1/jobs/detail,或提供可公開存取的 HTTPS custom_callback_url,把處理中、成功與失敗視為明確狀態分別處理。把圖像生成與編輯接進已在管理提示詞、審核與交付的產品。
Grok Image 的開發者應用情境
編輯類插圖
依文章企劃簡報生成原創場景概念圖,並送入審核佇列。
行銷創意變體
以提示詞驅動,產出支援的直式、方形或橫式長寬比的視覺方向。
參考圖引導的風格改寫
使用已核准的來源圖建立可控的視覺變化,供後續審核。
產品概念圖
把結構化的產品描述與選用的參考圖轉為視覺探索素材。
角色與場景發想
依描述性提示詞建立角色、道具與場景的草稿概念。
自動化創意流程
把非同步任務串接到回呼、內容審核、儲存、簽核與下游處理。
關於價格、輸入、長寬比與介接的常見問題解答。
