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

# GPT-Image 历史版本

> GPT-Image-1 / 1-mini / 1.5 历史模型概览，包含模型 ID、计费、端点与迁移到 GPT-Image-2 / GPT-Image-2-All 的建议。

<Info>
  新项目请直接使用 [GPT-Image-2](/api-capabilities/gpt-image-2/overview)（官方版）或 [GPT-Image-2-All](/api-capabilities/gpt-image-2-all/overview)（官逆，\$0.03/张统一价）。本页面仅保留历史版本的核心参数，方便老项目排查与迁移。
</Info>

## 历史版本一览

| 模型 ID              | 发布时间     | 端点                                          | 价格特点                               | 状态                      |
| ------------------ | -------- | ------------------------------------------- | ---------------------------------- | ----------------------- |
| `gpt-image-1.5`    | 2025年12月 | `/v1/images/generations`                    | 输入 \$5.00 / 输出 \$10.00 / 百万 tokens | 仍可用，建议升级至 `gpt-image-2` |
| `gpt-image-1`      | 2025年4月  | `/v1/images/generations`、`/v1/images/edits` | 输入 \$2.50 / 输出 \$8.00 / 百万 tokens  | 仍可用，建议升级至 `gpt-image-2` |
| `gpt-image-1-mini` | 2025年4月  | `/v1/images/generations`                    | 较 `gpt-image-1` 更低                 | 仍可用                     |

<Tip>
  **直接迁移**：把 `model` 改成 `gpt-image-2` 或 `gpt-image-2-all` 即可，参数（`size` / `quality` / `output_format` 等）大体兼容，无需改代码结构。
</Tip>

## 通用参数（生图）

历史版本共享一套生图参数：

| 参数                   | 说明                                                   |
| -------------------- | ---------------------------------------------------- |
| `model`              | `gpt-image-1.5` / `gpt-image-1` / `gpt-image-1-mini` |
| `prompt`             | 图像描述（最长 1000 字符）                                     |
| `size`               | `1024x1024` / `1536x1024` / `1024x1536` / `auto`     |
| `quality`            | `low` / `medium` / `high` / `auto`                   |
| `output_format`      | `png`（默认） / `jpeg` / `webp`                          |
| `output_compression` | 仅 JPEG / WebP，0–100%                                 |
| `background`         | `transparent` / `opaque` / `auto`                    |
| `n`                  | 生成数量（1–10）                                           |

## 快速调用示例

```python theme={null}
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"
)

response = client.images.generate(
    model="gpt-image-1.5",  {/* 也可填 gpt-image-1 / gpt-image-1-mini */}
    prompt="A professional product photo on white background, soft studio lighting",
    size="1024x1024",
    quality="high"
)

print(response.data[0].url)
```

## 按图片计费参考

GPT-Image-1 / 1.5 同时支持 Token 计费与按图片计费，系统自动取较优方式：

### GPT-Image-1.5

| 质量     | 1024×1024 | 1024×1536 / 1536×1024 |
| ------ | --------- | --------------------- |
| Low    | \$0.009   | \$0.013               |
| Medium | \$0.034   | \$0.050               |
| High   | \$0.133   | \$0.200               |

### GPT-Image-1

| 质量     | 1024×1024 | 1024×1536 / 1536×1024 |
| ------ | --------- | --------------------- |
| Low    | \$0.005   | \$0.006               |
| Medium | \$0.011   | \$0.015               |
| High   | \$0.036   | \$0.052               |

<Warning>
  按图片计费仅作参考。实际扣费以系统自动选择的更优方式（Token 或按图片）为准。
</Warning>

## 图像编辑（仅 `gpt-image-1`）

`gpt-image-1` 支持基于遮罩的局部编辑端点 `/v1/images/edits`：

```python theme={null}
response = client.images.edit(
    model="gpt-image-1",
    image=open("original.png", "rb"),
    mask=open("mask.png", "rb"),
    prompt="A modern glass skyscraper with reflective windows",
    size="1024x1024"
)
```

| 参数       | 说明                                 |
| -------- | ---------------------------------- |
| `image`  | 原图，PNG/WebP/JPG，单张 \< 50MB，最多 16 张 |
| `mask`   | 遮罩图，alpha=0 的区域将被重绘                |
| `prompt` | 描述要在遮罩区生成的内容                       |

<Note>
  新项目编辑场景推荐使用 [GPT-Image-2 编辑](/api-capabilities/gpt-image-2/image-edit)（官方）或 [GPT-Image-2-All 编辑](/api-capabilities/gpt-image-2-all/image-edit)（官逆，最多 16 张多图融合）。
</Note>

## 迁移到 GPT-Image-2 / 2-All

| 你的诉求                        | 推荐迁移到                             |
| --------------------------- | --------------------------------- |
| 沿用 OpenAI 官方端点、需要精确尺寸/质量控制  | `gpt-image-2`（官转）                 |
| 想要可预测的统一价（\$0.03/张）、提示词遵循更优 | `gpt-image-2-all`（官逆）             |
| 仍需图像编辑 + 遮罩                 | `gpt-image-2-all` 编辑端点（支持最多 16 张） |

<CardGroup cols={2}>
  <Card title="GPT-Image-2 概览" icon="bolt" href="/api-capabilities/gpt-image-2/overview">
    OpenAI 官方最新版，端点 / 参数与历史版兼容
  </Card>

  <Card title="GPT-Image-2-All 概览" icon="sparkles" href="/api-capabilities/gpt-image-2-all/overview">
    官逆通道，\$0.03/张统一价，速度更快
  </Card>

  <Card title="官转 vs 官逆 对比" icon="scale" href="/api-capabilities/gpt-image-2/vs-gpt-image-2-all">
    一文看懂两者的差异和选型建议
  </Card>
</CardGroup>