openai/gpt-image-2.5-sunburst

接入前必讀

以下參數依據 MaxAPI 公開配置；所選路由可能另有輸入或權限要求。

請求模型 ID

openai/gpt-image-2.5-sunburst

輸出類型

圖片

Base URL

https://api.maxapi.dev

生成方式

同步回傳或非同步任務

參考圖片・本站配置上限

16

品質參數

high / auto / medium / low / xhigh / max

解析度與尺寸

size 使用 WIDTHxHEIGHT。4K 橫向可使用 3840x2160；4K 不代表 4096x4096。

GPT Image 2.5：n=1；邊長須為 16 的倍數且不超過 3840px，總像素 655,360–8,294,400，長寬比介於 1:3 與 3:1。

參考素材必須是真實圖片，不可使用 HTML 錯誤頁、PDF 或只改副檔名的檔案。請確認檔案完整且可解碼；檔案體積小，也可能有過大的像素尺寸。先測通單張參考圖，再增加至完整組合。

模型特點與選型

資料核對 · 2026-09-10

此模型的資料來源: OpenAI · gpt-image-2.5-sunburst

何時值得選擇它

已核准的畫面只需受控修改時，優先把它納入比較，例如包裝、材質、短標籤或局部在地化。大量探索概念方向時，則可另外比較 Flare。

限制與注意事項

精細編輯不等於像素鎖定。必須列出不可改的區域並逐項驗收；實際品質參數以本站清單和路由行為為準，不能直接照搬官方直連 API 的全部選項。

供應商能力描述的是模型本身，不等於 MaxAPI 已開通全部功能。本站接入以此入口列出的參數、輸入類型和路由為準；供應商的速度、品質定位不是服務保證。

MaxAPI 實際如何處理請求

路由與價格

公開路由：mix、x、a。圖片／影片 JSON 請求可指定 route_mode；Gemini 原生請求使用 X-MaxAPI-Route-Mode。受限路由需帳戶與 API Key 同時具備權限。路由代表接入與計費選擇，不是另一個公開模型 ID。

1 積分 = 1 美元。此處為目錄基礎價格，並非帳戶即時報價；最終消耗依帳戶倍率與生效計費配置結算。Token 單價不等於每張圖片固定價格。

第一次呼叫

建立 MaxAPI API Key，並在服務端環境中設定 MAXAPI_KEY，請勿將金鑰放入瀏覽器程式碼。範例未指定路由時，依 API Key 的路由配置處理。

• POST /v1/images/generations
• POST /v1/images/edits
• GET /v1/images/generations/{task_id}
• GET /v1/images/edits/{task_id}

同步呼叫會等待生成結果。非同步圖片生成可在 JSON 內加入 async: true；Gemini 原生請求使用 X-MaxAPI-Async: true。保存回傳任務 ID，再輪詢上方對應的 GET 端點。

curl -X POST "https://api.maxapi.dev/v1/images/generations" \
  -H "Authorization: Bearer $MAXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2.5-sunburst",
    "prompt": "a clean product photo of a glass cube",
    "route_mode": "mix",
    "size": "1024x1024",
    "quality": "high",
    "n": 1
  }'

curl "https://api.maxapi.dev/v1/images/edits" \
  -H "Authorization: Bearer $MAXAPI_KEY" \
  -F "model=openai/gpt-image-2.5-sunburst" \
  -F 'prompt=Keep the product unchanged and replace the background with a soft gray studio backdrop.' \
  -F 'image=@reference.png' \
  -F 'size=1024x1024'

{
  "id": "example-task-id",
  "object": "image.generation.task",
  "status": "queued",
  "model": "openai/gpt-image-2.5-sunburst",
  "poll_url": "/v1/images/generations/example-task-id"
}

先看現象，再判斷錯誤原因