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

# GPT Image 2 API 接入

> 了解 GPT Image 2 的 Web 与 VIP 模型 ID、同步 Images 接口，以及统一异步生图和编辑任务。

OpenAI 官方模型 ID 是 `gpt-image-2`，当前模型页同时列出了日期快照 `gpt-image-2-2026-04-21`。官方将它用于图片生成、编辑和高保真图片输入，详情见 [GPT Image 2 模型页](https://developers.openai.com/api/docs/models/gpt-image-2)。

在本 API 中，请从下面两个公开 ID 中选择。带 `-web`、`-vip` 的名称属于 YingTu，不是可以直接发送给 OpenAI 的官方模型 ID。

## 先确定模型 ID

<CardGroup cols={2}>
  <Card title="gpt-image-2-web" icon="globe-2" href="/cn/models/image/gpt-image/gpt-image-2-web/overview">
    当前 USD 0.03/次；适合优先考虑固定价格的逆向图片任务。
  </Card>

  <Card title="gpt-image-2-vip" icon="gem" href="/cn/models/image/gpt-image/gpt-image-2-vip/overview">
    当前 USD 0.05/次；四档 quality 已覆盖完整调用流程。
  </Card>
</CardGroup>

当前两个模型 ID 都支持以下三档输出：

| 常用叫法  | 请求值         |
| ----- | ----------- |
| 1K 方图 | `1024x1024` |
| 2K 方图 | `2048x2048` |
| 4K 横图 | `3840x2160` |

4K 不应写成 `4096x4096`。OpenAI 的[图片生成指南](https://developers.openai.com/api/docs/guides/image-generation#customize-image-output)要求最长边不超过 3840 像素，输出面积不超过 8,294,400 像素。

## 三种已开放调用

* 文生图：`POST /v1/images/generations`
* 图生图：`POST /v1/images/edits`
* 任务式异步生成或编辑：`POST /v1/images/tasks`，设置 `action=generate|edit`，再查询 `GET /v1/tasks/{task_id}`

统一图片任务是 YingTu 扩展，不是 OpenAI 官方 Images API 路径。异步生图或使用 1～16 张参考图的编辑统一使用 `/v1/images/tasks`。

同步结果从 `data[0].b64_json` 读取 Base64 PNG。统一任务保持原生 ImagesResponse，从 `result.data[0].b64_json` 解码；响应不会增加自定义 `mime_type`。

## 当前不应推断的能力

当前逆向接口支持多张参考图，但每次只返回一张图片。不承诺蒙版、`n > 1`、透明背景、输出格式切换、partial image 流式返回、回调、取消或 OpenAI SDK 兼容。

下一步先看 [Web 与 VIP 对比](/cn/models/image/gpt-image/comparison)，再进入对应模型的参数和示例。

<CardGroup cols={2}>
  <Card title="确认 SDK 支持范围" icon="blocks" href="/cn/resources/sdk-and-protocol-compatibility">
    使用当前维护的 REST 接口，并了解 OpenAI SDK 的兼容限制。
  </Card>

  <Card title="联系 API 支持" icon="life-buoy" href="/cn/resources/technical-support">
    排障无效时提交脱敏的请求或任务标识。
  </Card>
</CardGroup>