---
title: GPT-Image-2 图片生成
description: 使用 gpt-image-2 或账户配置的图片模型生成图片。
openapi: openapi/model-api.json POST /v1/images/generations
---

模型 ID 以[模型列表](/api-reference/models/list)返回结果为准。纯文生图不需要参考素材；需要参考图片时，可使用平台上传流程，也可直接提供已有的公网 URL，然后传给图片编辑接口。

<Warning>
  本接口用于纯文生图。只要使用参考图片，就应改用[图片编辑](/api-reference/images/gpt-image-2/edit)。参考图片必须是公网 URL，可以是上传接口返回的 `public_url`，也可以是你自己提供的公网 URL。
</Warning>

## 参考图片的两种方式

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

调用 [`POST /v1/upload/presign`](/api-reference/uploads/file) 获取上传地址，完成 `PUT` 上传后，将响应中的 `public_url` 写入图片编辑请求的 `images[].image_url`。

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

如果图片已经部署在可公开访问的对象存储或 CDN，可跳过上传接口，直接填写 URL：

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

公网 URL 必须无需登录、无需 Cookie 或临时签名即可访问，并在任务执行期间保持有效。

## 分辨率与宽高比

| 档位 | 1:1 | 16:9 | 9:16 | 4:3 | 3:4 | 3:2 | 2:3 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| 1K | 1024x1024 | 1536x864 | 864x1536 | 1360x1024 | 1024x1360 | 1536x1024 | 1024x1536 |
| 2K | 2048x2048 | 3072x1728 | 1728x3072 | 2720x2048 | 2048x2720 | 3072x2048 | 2048x3072 |
| 4K | 2880x2880 | 3840x2160 | 2160x3840 | 3328x2496 | 2496x3328 | 3520x2336 | 2336x3520 |

接口可能直接返回 `data[].url`，也可能返回异步任务 ID。收到任务 ID 时使用[查询图片任务](/api-reference/images/gpt-image-2/status)轮询结果。