GPT Image 2 API 对接指南

更新日期：2026-07-21
适用模型：gpt-image-2、固定快照 gpt-image-2-2026-04-21
适用接口：POST /v1/images/generations、POST /v1/images/edits
适用场景：OpenAI 官方 API，以及兼容 OpenAI Images API 的 new-api 网关

gpt-image-2 是 OpenAI 当前推荐的新建图片生成与编辑工作流默认模型，支持文本生成图片、单图或多图编辑、遮罩编辑、任意合规分辨率，以及 PNG、JPEG、WebP 输出。模型会自动以高保真方式处理输入参考图。

本文示例不包含真实密钥。调用前请将网关地址和令牌写入环境变量：

PowerShell：

$env:AI_BASE_URL = "https://your-new-api.example.com"
$env:AI_API_KEY = "sk-your-token"

如果直接调用 OpenAI 官方 API，将 AI_BASE_URL 设置为 https://api.openai.com，并使用 OpenAI API Key。

1. 接入前检查

1.1 网关配置

管理员需要先完成以下配置：

创建或选择 OpenAI 类型渠道，上游地址配置正确。

渠道模型列表包含 gpt-image-2；需要固定行为时，也可以加入 gpt-image-2-2026-04-21。

如果外部模型名与上游模型名不同，配置模型映射。

令牌所在分组可以访问该渠道和模型，并已配置正确的计费策略。

上游 OpenAI 组织可能需要先完成 API Organization Verification。

不要通过 /v1/chat/completions 直接调用 gpt-image-2。单次生成或编辑应使用 Images API；需要多轮对话式改图时，使用 Responses API 的 image_generation 工具，详见第 8 节。

1.2 模型能力

项目	`gpt-image-2` 行为
输入	文本；编辑接口还支持一张或多张图片
输出	图片，Images API 响应中以 Base64 返回
生成接口	`POST /v1/images/generations`
编辑接口	`POST /v1/images/edits`
输出质量	`low`、`medium`、`high`、`auto`
输出格式	`png`、`jpeg`、`webp`
透明背景	不支持；不要发送 `background: "transparent"`
输入保真度	始终高保真；不要发送 `input_fidelity`
批量张数	`n` 为 1～10，默认 1
提示词长度	最长 32,000 字符
Images API 流式输出	OpenAI 官方支持；当前仓库网关图片链路暂不建议开启，见第 7 节

模型别名可能随官方升级而变化。要求可复现时使用固定快照；希望自动获得当前版本改进时使用 gpt-image-2。

2. 文本生成图片

2.1 最小请求

Images API 不返回长期有效的图片 URL。gpt-image-2 的图片位于 data[].b64_json，应用需要解码并自行保存。

Linux/macOS：

PowerShell：

$response = Get-Content -Raw .\response.json | ConvertFrom-Json
[IO.File]::WriteAllBytes(
  (Join-Path $PWD "output.png"),
  [Convert]::FromBase64String($response.data[0].b64_json)
)

gpt-image-2

GPT Image 2 API 对接指南#

1. 接入前检查#

1.1 网关配置#

1.2 模型能力#

2. 文本生成图片#

2.1 最小请求#