88API88API
使用指南AI 應用API 文件幫助支援
影像(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-image1K (預設) / 2K
aspect_ratio + resolution
最多 3 張 (Data URI / 公開 URL / 本機檔案)最多 10 張按張
grok-imagine-image-2.01K (預設) / 2K
aspect_ratio + resolution
最多 3 張 (Data URI / 公開 URL / 本機檔案)最多 10 張按張
grok-imagine-image-quality1K (預設) / 2K
aspect_ratio + resolution
最多 3 張 (Data URI / 公開 URL / 本機檔案)最多 10 張按張
grok-imagine-edit
等同於 grok-imagine-image-quality
1K (預設) / 2K
aspect_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

模型qualityresponse_format
grok-imagine-image不支援b64_json / url
grok-imagine-image-2.0low / medium / autob64_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。

各檔位的輸出像素(四個模型相同):

比例1K2K
1:11024x10242048x2048
16:91280x7202816x1584
9:16720x12801584x2816
4:31152x8642368x1776
3:4864x11521776x2368
3:21248x8322496x1664
2:3832x12481664x2496
2:11408x7042912x1456
1:2704x14081456x2912
19.5:91248x5762912x1344
9:19.5576x12481344x2912
20:91280x5763200x1440
9:20576x12801440x3200
21:91568x6723136x1344
5:21600x6403200x1280
  • 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
  }'

請求參數

參數型別必填說明
modelstring是模型名稱。
promptstring是圖片描述,不能為空。建議控制在幾千字以內。
aspect_ratiostring否畫面比例,預設 auto。
resolutionstring否1k(預設)或 2k。
ninteger否生成張數,1 至 10,預設 1。
response_formatstring否b64_json(預設)或 url。選 url 時回傳 88API 的圖片連結。
qualitystring否僅 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 張502Upstream request failed
內容審核未通過400图片生成未通过内容安全审核,请修改提示词或参考素材后重试。

表中的回傳訊息為 API 實際回傳的原文(簡體中文)。以上請求失敗不扣費。