Skip to main content

gpt-image-2 介面說明

gpt-image-2 支援文生圖和圖片編輯,同時提供 AIHubMix 統一生成端點與 OpenAI 相容端點。 新接入統一協定請參閱 圖片生成。本頁範例使用 OpenAI 相容端點。
本頁的生成、編輯、Base64 解碼與非法參數流程已使用 gpt-image-2 驗證。接入前請查詢 模型 Schema 介面,依 path 選擇端點並讀取 request.schema

準備工作

安裝或升級 OpenAI Python SDK,並透過環境變數提供 API Key:

生成圖片

生成一張低品質 1024x1024 PNG,並儲存回傳的 Base64 資料。
等價的 HTTP 請求:

編輯圖片

編輯端點接收 multipart/form-data。將原圖命名為 input.png 並放在目前目錄。
等價的 HTTP 請求:

已確認參數

不要將其他 GPT Image 版本的參數直接套用到 gpt-image-2。請以所選端點的 request.schema 為準。

回傳範例

兩個相容端點都回傳 OpenAI 圖片回應。data[].b64_json 是 Base64 圖片,usage 是 Token 用量。

錯誤回應

不支援的參數會回傳結構化 4xx。例如 quality: "ultra" 會回傳 HTTP 400
先檢查 error.paramerror.code,再依所選端點的 request.schema 修正請求。