> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qingbo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# GPT Image 系列

> OpenAI GPT Image 的四个模型：三个官方版按 token 用量计费，一个逆向版按张固定价

GPT Image 系列的四个模型都走 `POST /v1/tasks`，请求地址不随模型变化。它们的动作和请求形状一致，差别集中在画幅与分辨率的取值、专有参数和计费方式三处，选型只改 `model` 字段。

## 可用模型

<CardGroup cols={2}>
  <Card title="GPT Image 1" href="/cn/api-reference/image/gpt-image/gpt-image-1">
    `gpt-image-1` · 文生图、最多 15 张参考图编辑、掩码重绘与透明背景；按实际 token 用量结算
  </Card>

  <Card title="GPT Image 1.5" href="/cn/api-reference/image/gpt-image/gpt-image-1">
    `gpt-image-1.5` · 与 `gpt-image-1` 同一套动作和参数，计费维度多一项文本输出；按实际 token 用量结算
  </Card>

  <Card title="GPT Image 2 官方版" href="/cn/api-reference/image/gpt-image/gpt-image-2">
    `gpt-image-2` · 15 种画幅、`1k` / `2k` / `4k` 分辨率、最多 16 张参考图、掩码重绘与 WebP 输出；按实际 token 用量结算
  </Card>

  <Card title="GPT Image 2 逆向版" href="/cn/api-reference/image/gpt-image/gpt-image-2-rev">
    `gpt-image-2-rev` · 文生图与最多 15 张参考图编辑；按 `1k` / `2k` / `4k` 固定张价结算
  </Card>
</CardGroup>

## 如何选择

| 需求                                        | 推荐模型                                        | 原因                                |
| ----------------------------------------- | ------------------------------------------- | --------------------------------- |
| `2k` / `4k` 分辨率，或 `1:1` `2:3` `3:2` 之外的画幅 | `gpt-image-2`                               | 只有它接受 `resolution`，并支持 15 种画幅     |
| 提交前确定单张价格                                 | `gpt-image-2-rev`                           | 按输出分辨率固定计费，与画幅和提示词长度无关            |
| 掩码局部重绘、透明背景或输出格式控制                        | `gpt-image-1` `gpt-image-1.5` `gpt-image-2` | 三个官方版都提供这组专有参数                    |
| WebP 输出                                   | `gpt-image-2`                               | 另外三个模型只输出 `png` 和 `jpeg`          |
| 多图参考编辑                                    | 四个都支持                                       | `gpt-image-2` 最多 16 张，其余三个最多 15 张 |

<Note>
  模型之间不会自动切换：`model` 字段决定用哪个模型，参数以该模型的页面为准。
</Note>

## 共同点

以下部分四个模型完全一致：

| 项目   | 取值                                                   |
| ---- | ---------------------------------------------------- |
| 端点   | `POST /v1/tasks`（异步任务，见[任务系统](/cn/docs/task-system)） |
| 动作   | `generate` 文生图 · `edit` 参考图编辑（必须带 `image_urls`）      |
| 默认画幅 | `1:1`；可选画幅集合各模型不同，见各模型页                              |
| 每次输出 | 1 张                                                  |
| 不支持  | `seed`                                               |

## 统一调用方式

```bash theme={"system"}
curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "action": "generate",
    "prompt": "一只蓝色陶瓷杯放在白色桌面上，柔和自然光",
    "aspect_ratio": "1:1",
    "n": 1
  }'
```

把 `model` 换成本页任意一个模型 ID 都能直接跑。提交成功后返回 `task_id`。用 [`GET /v1/tasks/{task_id}`](/cn/api-reference/task/status) 查询结果，也可以用 [`Prefer: wait`](/cn/api-reference/task/submit#请求内等待prefer-wait) 在一次调用里等待，或配置 Webhook。

## 相关文档

* [GPT Image 1 与 1.5 官方版](/cn/api-reference/image/gpt-image/gpt-image-1)
* [GPT Image 2 官方版](/cn/api-reference/image/gpt-image/gpt-image-2)
* [GPT Image 2 逆向版](/cn/api-reference/image/gpt-image/gpt-image-2-rev)
* [提交任务](/cn/api-reference/task/submit)
* [查询任务状态](/cn/api-reference/task/status)
* [任务系统](/cn/docs/task-system)