GPT Image 系列

OpenAI 的圖片生成模型，共三款：gpt-image-2.5-flare、gpt-image-2.5-sunburst、gpt-image-2，皆透過 OpenAI 相容介面呼叫。

本系列文件的結論均來自實測介面，程式碼範例皆原樣執行通過。最近校驗：2026-09-30。

我要做什麼

文生圖用一段文字生成圖片。改圖與多圖上傳一張或多張圖片，依文字要求修改或融合。局部重繪用 mask 圈出區域，只重畫這一塊。用你自己的工具生圖不寫程式碼。Cherry Studio、LobeHub 填寫幾項設定，Claude Code、Codex 複製一段提示詞。

三個介面共用的請求結構與回應欄位，請見 Images API。

選擇哪個模型

重點文生圖選 gpt-image-2.5-flare，改圖選 gpt-image-2.5-sunburst。

gpt-image-2.5-flare文生圖首選

日常批次生成，出圖快
6 檔品質：low 至 max

Azure · OpenAI

gpt-image-2.5-sunburst改圖首選

改圖、多圖融合，以還原度為優先
6 檔品質：low 至 max

Azure · OpenAI

gpt-image-2上一代

既有專案可繼續使用
4 檔品質，無 xhigh、max

Azure · OpenAI

從 gpt-image-2 換到 2.5 時，需要重新選擇品質檔位，請見下方品質與價格。兩家供應商皆支援文生圖與改圖，閘道會自動路由。

模型 ID（呼叫時原樣複製）

文生圖openai/gpt-image-2.5-flare日常批次生成，出圖快

改圖openai/gpt-image-2.5-sunburst改圖、多圖融合，以還原度為優先

上一代openai/gpt-image-2沒有 xhigh、max 兩檔

品質（quality）與價格

重點明確傳入 quality，開發階段先用 low。不傳不等於 medium。

quality 對價格影響最大，檔位越高越貴、越慢。

OpenAI 官方參考價（每張，只計輸出圖片，不含提示詞與參考圖）：

檔位	`gpt-image-2` · 1024×1024	`gpt-image-2` · 1024×1536 或 1536×1024
`low`	$0.006	$0.005
`medium`	$0.053	$0.041
`high`	$0.211	$0.165

2.5 兩款官方沒有提供每張價格表，而是提供單價：輸出圖片每百萬 token $30，參考圖輸入每百萬 token $8，文字輸入每百萬 token $5。官方算例：1024×1024 的 low 檔輸出 196 個 token，約 $0.00588。其他檔位與尺寸可以用官方計算器估算。

以上為 OpenAI 官方資料，實際扣費以回應中的 usage 為準。OfoxAI 即時價格（含折扣）請見模型頁。

各模型支援的檔位：

檔位	2.5（flare、sunburst）	`gpt-image-2`
`low` / `medium` / `high`	支援	支援
`xhigh` / `max` 僅 2.5	支援	不支援，回傳 400
`auto` 或不傳易錯	由模型自行選擇，不等於 `medium`，建議明確指定	同左

不支援 standard 與 hd（DALL·E 的舊取值），傳入會回傳 400。

耗時與逾時（timeout）

重點將用戶端逾時設定為 600 秒。

介面為同步呼叫，圖片生成完成後才會回傳回應。用戶端提前中斷連線將無法取得圖片，但該請求仍會計費。

傳送請求生成中，可能需要數分鐘回傳圖片

60 / 120 秒 常見預設逾時，生成途中就會中斷，圖片遺失但仍計費

600 秒 建議設定，能等到圖片回傳

生成耗時隨模型、品質與尺寸而異，高品質、大尺寸及改圖請求可能需要數分鐘，常見的 60 秒或 120 秒預設逾時並不足夠。

尺寸（size）

重點寬、高都是 16 的倍數，且總像素不低於 655,360。

size 可以自訂寬高，格式為 寬x高，但必須同時滿足以下四項，任何一項不滿足都會回傳 400。

16 的倍數

寬、高都能被 16 整除

✗ 1000x1000

最長邊 ≤ 3840

任一邊都不超過 3840

✗ 4096x4096

寬高比 ≤ 3:1

寬高比在 1:3 到 3:1 之間

✗ 3200x1024

像素 ≥ 655,360易錯

總像素不低於 655,360

✗ 768x768 → ✓ 1024x768

不傳或傳 auto 易錯：由模型決定尺寸，不保證是 1024×1024，也不保證與參考圖一致。實測文生圖與改圖都回傳了 1254×1254。需要固定尺寸時，請明確傳入。

官方標示的上限為 3840×2160，超過 2560×1440 屬於實驗性解析度。

技術規格

項目	規格
回傳方式	同步回傳，圖片為 `data[0].b64_json` 中的純 base64
輸出尺寸	自訂寬高，需滿足四項限制，最大 3840×2160
品質檔位	請見品質與價格
輸出格式	png（預設）、jpeg、webp
單次張數	1–10 張，預設 1
參考圖	單張 ≤ 15 MB，整個請求 ≤ 50 MB，請見上傳限制
逾時	建議將用戶端逾時設定為 600 秒，請見耗時與逾時

指定供應商

重點一般不需要指定；指定後若該供應商無法使用，不會自動切換。

有內容審核方面的需求時可以指定，不同供應商的審核尺度不同，例如 gpt-image-2 在 Azure 上較嚴格、在 OpenAI 上相對寬鬆。

不指定（建議）

請求→OfoxAI 閘道→AzureOpenAI

閘道在 Azure 與 OpenAI 之間自動選擇可用的供應商。

指定供應商

請求openai→OfoxAI 閘道→AzureOpenAI

請求只送往該供應商；該供應商無法使用時，不會自動切換到其他供應商。

指定供應商的寫法

請求標頭X-OfoxAI-Provider-Type: openai文生圖與改圖介面皆適用；可選值為 azure_foundry、openai

請求主體"extra_body": { "provider": { "type": "openai" } }僅限文生圖介面；改圖介面為 multipart 上傳，只能使用請求標頭

完整說明請見供應商路由。

常見錯誤

重點先看錯誤原文。安全攔截 moderation_blocked 與逾時最常見。

錯誤	原因	處理方式
`moderation_blocked`（Your request was rejected by the safety system）高頻	提示詞或參考圖被上游安全系統攔截	修改提示詞或參考圖後再試，原樣重試結果不變。有審核需求時可考慮指定供應商
請求逾時、`504`、`524`、`Request timed out` 高頻	用戶端或中間代理（Nginx、Vercel、Cloudflare 等）的逾時短於生成耗時	將用戶端及中間代理的逾時設定為 600 秒，請見耗時與逾時
`404 model_not_found`	模型 ID 拼錯或大小寫不正確，例如寫成 `GPT-Image-2`	從本頁複製模型 ID，全部小寫
`provider_type_unavailable`	手動指定的供應商不提供此模型	移除供應商參數，讓閘道自動路由
`unknown provider type`	請求標頭中的供應商名稱拼錯	檢查拼字
`Invalid size`	尺寸不滿足四項限制	請見尺寸
`does not support quality 'xhigh'`	對 `gpt-image-2` 傳入了 `xhigh` 或 `max`	改用 `high`，或換用 2.5
`Invalid value: 'standard'`	`quality` 傳入了 `standard` 或 `hd`	改用 `low` 到 `max`
`Invalid image file or mode`	參考圖或 mask 格式不正確	重新匯出為標準 PNG 或 JPEG
`Invalid file 'image[0]': unsupported mimetype`	上傳的檔案不是圖片	上傳 PNG、JPEG 或 WebP 圖片
`does not support the 'input_fidelity' parameter`	改圖請求傳入了 `input_fidelity`	刪除該參數。2.5 與 `gpt-image-2` 一律以高保真處理參考圖
`Transparent background is not supported for JPEG output format`	透明背景搭配了 `jpeg` 格式	改用 `png` 或 `webp`
`Unknown parameter`	傳入了本系列不支援的參數	刪除該參數
`429 rate_limit_exceeded`	超過每分鐘 100 次（以團隊合計）	稍後重試。增加 Key 不會提高限額

完整錯誤碼請見 Error Handling。

錯誤原文

實測回傳的完整錯誤訊息，方便依原文搜尋與比對：


Invalid size '1000x1000'. Width and height must both be divisible by 16.
Invalid size '4096x4096'. The longest edge must be less than or equal to 3840.
Invalid size '3200x1024'. The maximum supported aspect ratio is 3:1.
Invalid size '768x768'. Requested resolution is below the current minimum pixel budget.
The model 'gpt-image-2' does not support quality 'xhigh'.
Invalid value: 'standard'. Supported values are: 'low', 'medium', 'high', and 'auto'.
Invalid 'n': integer above maximum value. Expected a value <= 10, but got 11 instead.
Unknown parameter: 'style'.
The model 'gpt-image-2.5-sunburst' does not support the 'input_fidelity' parameter.
Transparent background is not supported for JPEG output format
Invalid file 'image[0]': unsupported mimetype ('text/plain; charset=utf-8'). Supported file formats are 'image/jpeg', 'image/png', and 'image/webp'.
unknown provider type in X-OfoxAI-Provider-Type header
Model 'GPT-Image-2' not found
Invalid image file or mode for image 1

請注意 Invalid value: 'standard' 這則訊息列出的可選值並不完整：2.5 兩款還支援 xhigh 與 max。請以本頁的檔位表為準。

不生效的參數

重點不報錯不等於生效。

以下參數傳入後不會報錯，但對本系列沒有效果，請求照常成功、照常計費：

參數	原因
`mask`（文生圖介面）	只在改圖介面生效
`response_format`	DALL·E 的舊參數，本系列固定回傳 base64（`b64_json`）。直連 OpenAI 時會回傳 `Unknown parameter: 'response_format'`，透過 OfoxAI 呼叫則會被忽略
`input_fidelity`（文生圖介面）	屬於 `gpt-image-1.5`。注意：傳到改圖介面會回傳 400
`input_images`	屬於 Qwen 圖片系列

注意：不報錯不等於生效。例如 style 會直接報錯，而上面這幾個則會被靜默忽略。

官方文件

OpenAI 官方文件描述的是直連 OpenAI 時的行為。在 OfoxAI 上呼叫時，以本系列文件的實測結論為準，例如價格以回應中的 usage 與模型頁為準。

常見問題

GPT Image 2.5 的 size 支援任意尺寸嗎？

可以自訂寬高，但必須同時滿足四項限制：寬高都能被 16 整除、最長邊不超過 3840、寬高比在 1:3 到 3:1 之間、總像素不低於 655,360。任何一項不滿足都會回傳 400。例如 768x768 像素不足，會被拒絕；1024x768 則可以。

不傳 size 時輸出多大？

由模型決定，不一定是 1024x1024，也不一定與參考圖一致。實測文生圖與改圖都回傳了 1254x1254。需要固定尺寸時請明確傳入。

gpt-image-2 支援 xhigh 與 max 品質嗎？

不支援，傳入會回傳 400。xhigh 與 max 只有 gpt-image-2.5-flare 與 gpt-image-2.5-sunburst 支援。gpt-image-2 可選 low、medium、high、auto。

GPT Image 2.5 的 quality 可以填 hd 或 standard 嗎？

不可以，會回傳 400。可選值為 low、medium、high、xhigh、max、auto。不傳時由模型自行選擇檔位，實測會選 low；若需要穩定的品質，請明確指定。

gpt-image-2 / GPT Image 2.5 API 的逾時應設定多少？

建議將用戶端逾時設定為 600 秒。生成耗時隨模型、品質與尺寸而異，高品質、大尺寸及改圖請求可能需要數分鐘。

GPT Image 回傳 moderation_blocked（Your request was rejected by the safety system）該如何處理？

提示詞或參考圖被上游安全系統攔截，常見於真實人物、受著作權保護的角色或敏感內容。修改提示詞或參考圖後再試，原樣重試結果不會改變。回應中的 error.moderation_details 會說明攔截發生在輸入或輸出階段。不同供應商的審核尺度不同，有審核需求時可考慮指定供應商。

GPT Image 回傳 Unknown parameter: response_format 該如何處理？

response_format 是 DALL·E 的舊參數，GPT Image 只回傳 base64（data[0].b64_json），不提供圖片 URL。請刪除 response_format，改用 output_format 指定 png、jpeg 或 webp。透過 OfoxAI 呼叫時該參數會被忽略，不會報錯。

呼叫 gpt-image 時出現 Your organization must be verified 該如何處理？

這是直連 OpenAI 時對組織的驗證要求。透過 OfoxAI 呼叫不需要自行完成組織驗證，使用 OfoxAI 的 API Key 即可呼叫 gpt-image-2.5-flare、gpt-image-2.5-sunburst 與 gpt-image-2。

GPT Image 請求逾時、回傳 504 或 524 該如何處理？

介面為同步呼叫，高品質、大尺寸及改圖請求可能需要數分鐘。請將用戶端逾時設定為 600 秒，並檢查 Nginx、Vercel、Cloudflare 等中間代理的逾時設定，它們的預設值通常只有 60 至 100 秒。

GPT Image 回傳 does not support the input_fidelity parameter 該如何處理？

GPT Image 2.5 與 gpt-image-2 一律以高保真處理參考圖，改圖介面不接受 input_fidelity 參數，刪除即可。該參數僅適用於 gpt-image-1.5。

GPT Image 回傳 Invalid size 該如何處理？

size 不滿足四項限制之一。錯誤原文會說明是哪一項：divisible by 16 表示寬高不是 16 的倍數；longest edge 表示最長邊超過 3840；aspect ratio 表示寬高比超過 3:1；minimum pixel budget 表示總像素不到 655,360，例如 768x768。改成同時滿足四項的尺寸即可，例如 1024x768、1024x1024、1536x1024。

GPT Image 生成一張圖多少錢？

依 token 計費，品質檔位影響最大。OpenAI 官方參考價：gpt-image-2 生成 1024x1024 的圖，low 約 $0.006，medium 約 $0.053，high 約 $0.211。2.5 兩款輸出圖片每百萬 token $30，1024x1024 的 low 約 $0.006。實際扣費以回應中的 usage 為準，OfoxAI 即時價格請見模型頁。

GPT Image 2.5 改圖需要指定供應商嗎？

不需要。Azure 與 OpenAI 兩家都提供 2.5 的改圖介面，閘道會自動路由。