Skip to main content
POST
文生图:根据文本描述生成图片
右側的互動式 Playground 支援直接線上除錯。請在 Authorization 中填入你的 API Key(格式:Bearer sk-xxx),輸入 prompt、選擇 size / quality 後一鍵傳送即可。
場景說明:本頁用於「文本生成圖片」。只需輸入提示詞即可,無需上傳任何圖片。如需根據現有圖片做編輯、多圖融合或 mask 局部重繪,請使用 圖片編輯介面
🖥️ 瀏覽器 Playground 限制(重要)本介面的響應包含純 base64 字串(數 MB 量級)。受瀏覽器渲染限制,右側 Playground 在收到響應後可能彈出 請求時發生錯誤: unable to complete request ——實際請求已經成功,只是瀏覽器無法把這麼長的 base64 顯示出來。推薦做法(小白零踩坑):
  • 直接複製下方”程式碼示例”中的 Python / Node.js / cURL 到本地執行,程式碼會自動 base64.b64decode 並把圖片儲存為本地檔案
  • 如要在瀏覽器裡試 Playground,把 size 設為最小檔(如 1024x1024)、quality 改為 low,縮小響應體積。
圖片 API 全部為同步呼叫:沒有非同步任務 ID,客戶端斷開連線結果即丟失、但請求仍會計費。請為本模型設定足夠大的 timeout,詳見 圖片 API 呼叫須知與最佳實踐
⚠️ 不支援的引數
  • input_fidelity —— gpt-image-2 強制啟用高保真,傳了會 400 報錯(從 1.5 遷移時直接刪掉這一行)
  • background: "transparent" —— 暫不支援透明背景,請改用 opaque 或自行後處理摳透明
超過 2560×1440 的輸出仍屬實驗性,生產環境建議優先用預設尺寸:2048x1152 / 2048x2048 / 3840x2160

程式碼示例

Python(OpenAI SDK 直連)

Python(原生 requests)

cURL

Node.js(原生 fetch)

瀏覽器 JavaScript(直接渲染)

引數說明速查

quality 不要傳舊版 DALL·E 的 standard / hd 只接受 low / medium / high / auto 四個官方列舉值。舊值在不同後端渠道下行為不一致:有時直接 400 報錯(invalid_value),有時被靜默忽略、按 auto 檔跑出結果(費用不可控)。請始終顯式傳四個官方值之一。
詳細的引數約束、可選值、示例請檢視右側 Playground 中的欄位說明,所有 enum 欄位均支援下拉選擇。

響應格式

⚠️ b64_json 欄位是純 base64不含 data:image/...;base64, 字首。客戶端需要:
  • 寫檔案base64.b64decode(b64_str) → 寫入磁碟
  • 瀏覽器渲染:自行拼字首 data:image/png;base64, + b64
gpt-image-2-all / gpt-image-2-vip 實測(2026-07)同樣返回純 base64,但其歷史版本曾帶字首——跨模型複用程式碼時建議統一做 startsWith('data:') 檢測。
usage 欄位反映本次實際計費的 token 數,input_tokens_details / output_tokens_details 把文本、圖片兩段 token 拆開列出(純文生圖時 image_tokens 恆為 0)。詳細的欄位說明和自行核算公式見 概覽頁「如何檢視每次呼叫的真實 token 數」

授權

Authorization
string
header
必填

在 API易控制台获取的 API Key

主體

application/json
model
enum<string>
預設值:gpt-image-2
必填

模型名称,固定为 gpt-image-2

可用選項:
gpt-image-2
prompt
string
必填

提示词,支持中英文。建议把场景描述放在最前面

範例:

"赛博朋克城市雨夜,霓虹招牌特写,电影画幅"

size
string
預設值:auto

输出尺寸。预设值:1024x1024 / 1536x1024 / 1024x1536 / 2048x2048 / 2048x1152 / 3840x2160 / 2160x3840。 也可使用任意合法自定义尺寸(满足:最大边 ≤ 3840、两边 16 倍数、比例 ≤ 3:1、总像素 0.65–8.3MP)。

範例:

"2048x1152"

quality
enum<string>
預設值:auto

画质档位。low(草图/批量)、medium(日常)、high(终稿/精细文字)、auto(默认)

可用選項:
auto,
low,
medium,
high
output_format
enum<string>
預設值:png

输出格式

可用選項:
png,
jpeg,
webp
output_compression
integer

输出压缩率(0–100),仅 jpeg/webp 生效

必填範圍: 0 <= x <= 100
範例:

85

background
enum<string>
預設值:auto

背景模式。auto(默认)或 opaque。不支持 transparent

可用選項:
auto,
opaque
moderation
enum<string>
預設值:auto

审核强度。auto(默认)或 low(低强度)

可用選項:
auto,
low
n
enum<integer>
預設值:1

出图数量。本模型仅支持 1

可用選項:
1

回應

成功生成图片

created
integer

Unix 时间戳

範例:

1776832476

data
object[]

生成结果数组(本模型单次返回 1 张)

usage
object

本次调用 token 用量(用于按 token 计费核算)