用於生成與編輯的 Grok Image API

透過獨立的 GoEnhance API 使用 Grok Image。可以從文字提示詞生成,也可以提供最多九張參考圖進行圖生圖編輯,再以輪詢或 HTTPS 回呼取得非同步結果。GoEnhance 不是 xAI,此介面也不是 xAI 官方 API。
建立 API Key
未來感創意實驗室中的抽象光影藝術作品,象徵 Grok Image API

一個端點同時支援新圖生成與參考圖編輯

電影感武士場景,象徵由提示詞驅動的 Grok Image 生成
時尚大片風格人像,象徵參考圖引導的圖像編輯
只使用文件中列出的請求欄位,並在送出前完成驗證。

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. 建立 API Key
1

1. 建立 API Key

建立 GoEnhance Key,並在伺服器端的 Authorization 標頭中傳送。
2. 組出請求
2

2. 組出請求

model: grok-image 發出 POST 請求並附上提示詞。要做參考圖編輯就加上 image_list,要做文字生成圖像則選擇支援的長寬比。
3. 追蹤任務並讀取結果
3

3. 追蹤任務並讀取結果

從成功回應中讀取 data.img_uuid,並與你自己的任務紀錄關聯。接著輪詢 GET /api/v1/jobs/detail,或提供可公開存取的 HTTPS custom_callback_url,把處理中、成功與失敗視為明確狀態分別處理。
把圖像生成與編輯接進已在管理提示詞、審核與交付的產品。

Grok Image 的開發者應用情境

編輯類插圖

依文章企劃簡報生成原創場景概念圖,並送入審核佇列。

行銷創意變體

以提示詞驅動,產出支援的直式、方形或橫式長寬比的視覺方向。

參考圖引導的風格改寫

使用已核准的來源圖建立可控的視覺變化,供後續審核。

產品概念圖

把結構化的產品描述與選用的參考圖轉為視覺探索素材。

角色與場景發想

依描述性提示詞建立角色、道具與場景的草稿概念。

自動化創意流程

把非同步任務串接到回呼、內容審核、儲存、簽核與下游處理。
關於價格、輸入、長寬比與介接的常見問題解答。

Grok Image API 常見問題

用 Grok Image API 開始打造