---
title: GPT-Image-2 图片编辑
description: 使用公网参考图片进行编辑或参考生成。
openapi: openapi/model-api.json POST /v1/images/edits
---

<Warning>
  每张参考图片都必须填写模型服务可访问的公网 URL。你可以先调用 [`POST /v1/upload/presign`](/api-reference/uploads/file) 获取 `public_url`，也可以直接填写自己已有的公网 URL。模型接口不接收本地路径、Base64、multipart 文件体或预签名上传地址。
</Warning>

## 参考图片的两种来源

### 方式一：使用平台上传流程

<Steps>
  <Step title="申请上传地址">为每张图片调用 `POST /v1/upload/presign`。</Step>
  <Step title="上传参考图片">分别向返回的 `url` 发送 `PUT` 请求，并携带返回的 `headers`。</Step>
  <Step title="提交图片编辑">把每个 `public_url` 写入 `images[].image_url`，再调用本接口。</Step>
  <Step title="获取结果">直接读取 `data[].url`；如果返回任务 ID，则调用[查询图片任务](/api-reference/images/gpt-image-2/status)。</Step>
</Steps>

### 方式二：直接提供公网 URL

已有公网图片时，可跳过前两步，直接在 `images[].image_url` 中填写 URL：

```json
{
  "images": [
    { "image_url": "https://cdn.example.com/reference/person.png" }
  ]
}
```

URL 必须无需登录、无需 Cookie 或临时签名即可访问，并在任务执行期间保持有效。请确认模型服务所在网络可以访问该地址。

单图可用于背景替换、风格转换和局部重绘；多图可分别提供人物、服装、场景或风格参考。参考图片数量上限由目标模型决定。