影像(Image)
Grok 圖片模型 API
Grok Imagine 圖片模型(grok-imagine-image、2.0、quality、edit)的文生圖與圖片編輯介面、比例、解析度、參考圖和錯誤訊息說明。
適用範圍
本頁介紹 Grok Imagine 圖片模型。影片模型請參閱 Grok 影片 API。
介面選擇
Grok 圖片模型使用與 OpenAI Images 相容的介面:
| 用途 | 請求方法 | 端點 |
|---|---|---|
| 文生圖 | POST | /v1/images/generations |
| 圖片編輯(圖生圖) | POST | /v1/images/edits |
不支援 /v1/chat/completions 和 /v1/responses。參考圖只能透過 /v1/images/edits 傳入,寫在 /v1/images/generations 裡會被忽略。
模型與能力
| 模型 | 解析度 | 參考圖 | 單次張數 | 計費 |
|---|---|---|---|---|
grok-imagine-image | 1K (預設) / 2Kaspect_ratio + resolution | 最多 3 張 (Data URI / 公開 URL / 本機檔案) | 最多 10 張 | 按張 |
grok-imagine-image-2.0 | 1K (預設) / 2Kaspect_ratio + resolution | 最多 3 張 (Data URI / 公開 URL / 本機檔案) | 最多 10 張 | 按張 |
grok-imagine-image-quality | 1K (預設) / 2Kaspect_ratio + resolution | 最多 3 張 (Data URI / 公開 URL / 本機檔案) | 最多 10 張 | 按張 |
grok-imagine-edit等同於 grok-imagine-image-quality | 1K (預設) / 2Kaspect_ratio + resolution | 最多 3 張 (Data URI / 公開 URL / 本機檔案) | 最多 10 張 | 按張 |
支援的比例:auto (預設) / 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 2:1 / 1:2 / 19.5:9 / 9:19.5 / 20:9 / 9:20 / 21:9 / 5:2
| 模型 | quality | response_format |
|---|---|---|
grok-imagine-image | 不支援 | b64_json / url |
grok-imagine-image-2.0 | low / medium / auto | b64_json / url |
grok-imagine-image-quality | 不支援 | b64_json / url |
grok-imagine-edit | 不支援 | b64_json / url |
- 四個模型都能文生圖,也都能編輯圖片。
grok-imagine-edit與grok-imagine-image-quality是同一個模型,輸出效果一致。quality參數只對grok-imagine-image-2.0生效。- 按成功回傳的張數計費,與解析度、參考圖張數無關。
實際可用模型以控制台回傳的模型列表為準。
驗證
Authorization: Bearer $API_KEY
Content-Type: application/json比例與解析度
aspect_ratio:見上方能力表。預設auto,由模型依提示詞選擇畫幅,同一提示詞每次的比例不一定相同;需要固定尺寸時請明確傳入。resolution:1k(預設)或2k,不支援 4K。
各檔位的輸出像素(四個模型相同):
| 比例 | 1K | 2K |
|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 |
| 16:9 | 1280x720 | 2816x1584 |
| 9:16 | 720x1280 | 1584x2816 |
| 4:3 | 1152x864 | 2368x1776 |
| 3:4 | 864x1152 | 1776x2368 |
| 3:2 | 1248x832 | 2496x1664 |
| 2:3 | 832x1248 | 1664x2496 |
| 2:1 | 1408x704 | 2912x1456 |
| 1:2 | 704x1408 | 1456x2912 |
| 19.5:9 | 1248x576 | 2912x1344 |
| 9:19.5 | 576x1248 | 1344x2912 |
| 20:9 | 1280x576 | 3200x1440 |
| 9:20 | 576x1280 | 1440x3200 |
| 21:9 | 1568x672 | 3136x1344 |
| 5:2 | 1600x640 | 3200x1280 |
- 1K 輸出為 JPEG,2K 輸出為 PNG,無法透過
output_format變更。 - 也可以用 OpenAI 慣用的
size(例如1024x1024),會自動換算:長邊不超過 1024 按1k,超過則按2k,比例取最接近的支援值,因此回傳像素不一定等於請求的size。1536x1024、1792x1024都會按2k輸出。 - 同時傳入
size和aspect_ratio/resolution時,以aspect_ratio/resolution為準。
文生圖
curl https://api.88api.ai/v1/images/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-image",
"prompt": "雨夜霓虹燈下的東京街頭,電影感,寫實攝影",
"aspect_ratio": "16:9",
"resolution": "2k",
"n": 1
}'請求參數
| 參數 | 型別 | 必填 | 說明 |
|---|---|---|---|
model | string | 是 | 模型名稱。 |
prompt | string | 是 | 圖片描述,不能為空。建議控制在幾千字以內。 |
aspect_ratio | string | 否 | 畫面比例,預設 auto。 |
resolution | string | 否 | 1k(預設)或 2k。 |
n | integer | 否 | 生成張數,1 至 10,預設 1。 |
response_format | string | 否 | b64_json(預設)或 url。選 url 時回傳 88API 的圖片連結。 |
quality | string | 否 | 僅 grok-imagine-image-2.0:low、medium、auto(預設,生成時按 low、編輯時按 medium)。medium 生成較慢。 |
style、seed、negative_prompt、background、output_format、stream 等參數會被忽略。
回應範例
{
"created": 1760000000,
"data": [
{ "b64_json": "/9j/4AAQ...", "mime_type": "image/jpeg" }
]
}回應不包含 revised_prompt。
圖片編輯
JSON 請求(建議,支援多張參考圖)
單張參考圖用 image,多張參考圖用 images 陣列,最多 3 張:
curl https://api.88api.ai/v1/images/edits \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-image-quality",
"prompt": "把第一張圖中的人物放進第二張圖的場景裡,保持人物外貌不變",
"images": [
"data:image/png;base64,...",
"https://example.com/scene.jpg"
],
"resolution": "2k"
}'- 參考圖可以是 Data URI 或可公開直接下載的網址。Base64 必須帶有
data:image/...;base64,前綴。 - 支援 JPG、PNG、WebP,不支援 GIF、BMP。
- 不要把
image寫成陣列,也不要同時傳入image和images。 - 參考圖按傳入順序編號,提示詞裡可以用「第一張」「第二張」指稱。
- 未指定比例時,輸出比例跟隨第一張參考圖,解析度預設
1k;可以用aspect_ratio、resolution覆寫。
multipart 上傳(單張)
本機檔案也可以用 multipart 上傳,但每次只能傳一張,單一檔案不超過 20 MB:
curl https://api.88api.ai/v1/images/edits \
-H "Authorization: Bearer $API_KEY" \
-F "model=grok-imagine-image" \
-F "image=@input.png" \
-F "prompt=把背景換成海邊夕陽" \
-F "aspect_ratio=1:1"需要多張參考圖時請使用 JSON 請求。
限制
- 不支援
mask局部重繪,傳入的遮罩會被忽略。 - 不支援串流輸出和非同步取得結果。
- 輸出圖片帶有 C2PA 內容憑證(標記為 AI 生成),沒有可見浮水印。
常見錯誤
| 情境 | HTTP | 回傳訊息 |
|---|---|---|
| 呼叫對話或 Responses 介面 | 400 | <模型> 是生图模型,不支持 <接口> 接口。请改用:POST /v1/images/generations, POST /v1/images/edits |
| 比例不支援 | 400 | 不支持的图片比例。支持:… |
解析度不支援(例如 4k) | 400 | 不支持的图片分辨率。resolution 仅支持 1k 或 2k,请使用小写格式。 |
n 超出 1 至 10、prompt 為空、同時傳入 image 和 images、multipart 傳多張圖 | 400 | 上游拒绝了请求参数(invalid-argument),请检查模型名、调用接口和请求参数 |
| 參考圖格式不支援、Base64 缺少前綴、網址無法下載 | 400 | 與參考圖相關的錯誤提示 |
| 參考圖超過 3 張 | 502 | Upstream request failed |
| 內容審核未通過 | 400 | 图片生成未通过内容安全审核,请修改提示词或参考素材后重试。 |
表中的回傳訊息為 API 實際回傳的原文(簡體中文)。以上請求失敗不扣費。