GPT Image 2 图生图（编辑）

GPT Image 2 图生图

参考图编辑、风格迁移、虚拟换装、多图组合、局部重绘。本接口返回 base64（data[].b64_json）；同模型在 /v1/images/generations 返回 url。

带参考图的请求 input_tokens 高于纯文生图（输入图以高保真处理，单图约 255 image tokens；input_fidelity=high 时更高）。

接入地址

线路	Base URL	说明
国内加速（推荐）	`https://cdn.wusag.com`	走国内 CDN 节点
海外直连	`https://api.xinliu.one`	海外服务器或加速节点异常时使用

两个地址共用同一账户和 Key。

请求

方法：POST {Base URL}/v1/images/edits

Header：

Authorization: Bearer 你的令牌

Content-Type: multipart/form-data（curl 用 -F 时自动设置）

可用模型

model	备注
`gpt-image-2`	标准版
`gpt-image-2-pro`	Pro 版
`gpt-image-2-2026-04-21`	OpenAI 官方版本（直连）

表单字段

字段	类型	必填	说明
`model`	string	是	见上表
`prompt`	string	是	编辑指令，最大 32000 字符
`image`	file	是	原图，可重复多次（多图组合）。支持 `png` / `jpeg` / `webp`，单文件 ≤ 50 MB
`mask`	file	否	遮罩 PNG，alpha 透明区为重绘区域。GPT Image 模型把遮罩视为提示而非精确边界
`n`	int	否	生成数量，1~10，默认 1
`size`	string	否	输出尺寸，见下表；默认 `auto`
`quality`	string	否	`low` / `medium` / `high` / `auto`（默认）
`background`	string	否	`auto`（默认）/ `opaque`。`gpt-image-2` 不支持 `transparent`
`output_format`	string	否	`png`（默认）/ `webp` / `jpeg`
`output_compression`	int	否	0~100，仅 `webp` / `jpeg`，默认 100
`moderation`	string	否	`auto`（默认）/ `low`
`input_fidelity`	string	否	`low`（默认）/ `high`。`high` 保留原图细节更完整，多图时首张保留纹理最多，消耗更多 image input tokens
`stream`	bool	否	是否流式返回，默认 `false`
`partial_images`	int	否	流式中间图数量，0~3。`stream=true` 时必须 ≥ 1
`user`	string	否	终端用户唯一标识

`size` 取值

取值	说明
`1024x1024`	正方形
`1536x1024`	横版
`1024x1536`	竖版
`2048x2048`	2K 正方形
`2048x1152`	2K 横版
`3840x2160`	4K 横版
`2160x3840`	4K 竖版
`auto`	默认

自定义尺寸约束同 generations。

单图编辑示例

多图组合（image 重复多次）

局部重绘（带遮罩）

高保真编辑（input_fidelity=high）

Python 示例

Node.js 示例

返回字段

字段	类型	说明
`data[].b64_json`	string	base64 编码图像
`data[].revised_prompt`	string	模型对原始 prompt 的改写（如启用）
`created`	int	Unix 时间戳
`usage.input_tokens`	int	输入 token 总数（含图像）
`usage.output_tokens`	int	输出图像 token
`usage.total_tokens`	int	总 token
`usage.input_tokens_details.text_tokens`	int	prompt 文本 token
`usage.input_tokens_details.image_tokens`	int	输入图 token（单图约 255）

返回示例

{
  "data": [{ "b64_json": "iVBORw0KGgo..." }],
  "created": 1778069633,
  "usage": {
    "input_tokens": 259,
    "output_tokens": 765,
    "total_tokens": 1024,
    "input_tokens_details": { "text_tokens": 4, "image_tokens": 255 }
  }
}

base64 直接解码：atob(b64_json) 或 base64.b64decode(b64_json) 写入 .png 文件即可。

流式（stream=true）

服务端按 Server-Sent Events 推送：先若干条 partial_image 事件，再一条最终事件。partial_images 必须 ≥ 1。

错误码

通用错误体：

{
  "error": {
    "message": "具体错误描述",
    "type": "invalid_request_error",
    "param": "image",
    "code": "invalid_value"
  }
}

状态码	说明
`400`	参数错误（`invalid_request_error`，如 `image` 未提供 / 文件超 50 MB / `size` 越界）
`401`	令牌无效或未提供
`402`	余额不足
`404`	模型不存在或未开通
`413`	上传文件过大
`429`	速率限制
`500`	服务端错误

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart