> ## 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 VIP 参数

> 查询 gpt-image-2-vip 的 size、quality、单图或多图输入、幂等任务、原生 ImagesResponse 和错误。

公开模型 ID：

```text theme={"system"}
gpt-image-2-vip
```

## 尺寸与质量

| 字段        | 支持值                                        |
| --------- | ------------------------------------------ |
| `size`    | 明确传入 `1024x1024`、`2048x2048` 或 `3840x2160` |
| `quality` | `low`、`medium`、`high`、`auto`               |
| `n`       | 省略或 `1`                                    |
| 返回图片      | `data[0].b64_json` 中的一张 PNG                |

OpenAI 官方模型还允许符合约束的其他尺寸，具体条件见[图片生成指南](https://developers.openai.com/api/docs/guides/image-generation#customize-image-output)。本 API 的 Generate、Async Generate 和 Edit 当前公开三档尺寸。需要准确像素时应明确传入 `size`；省略后的像素尺寸不在当前公开范围内。

## Generate 请求体

```json theme={"system"}
{
  "model": "gpt-image-2-vip",
  "prompt": "日出沙漠中的银色玩具火箭，不要文字",
  "size": "2048x2048",
  "quality": "medium",
  "n": 1
}
```

将该 JSON 发送到 `/v1/images/generations` 完成同步生图。

## 统一异步请求

异步任务发送到 `/v1/images/tasks`。生图使用 `action=generate` 并省略 `input_images`；编辑使用 `action=edit`，提供 1～16 张 Base64 图片：

```json theme={"system"}
{
  "model": "gpt-image-2-vip",
  "action": "edit",
  "prompt": "保留产品主体，把背景替换为浅蓝色",
  "input_images": [
    {"mime_type": "image/png", "data": "BASE64_SOURCE_IMAGE_1"},
    {"mime_type": "image/jpeg", "data": "BASE64_SOURCE_IMAGE_2"}
  ],
  "size": "2048x2048",
  "quality": "high",
  "n": 1
}
```

每张来源图 Base64 解码后不得超过 20 MiB，全部来源图合计不超过 64 MiB；`mime_type` 必须与实际 PNG、JPEG 或 WebP 字节一致。GPT Image 任务不传 `aspect_ratio`，可能重试时设置 `Idempotency-Key`。

## Edit 表单

`/v1/images/edits` 使用 multipart。上传一张 `image`，同时提交 `model`、`prompt`、`size`、`quality`，`n` 省略或设为 `1`。

同步 multipart Edit 的来源图没有对外承诺固定的字节或像素上限；如果收到 HTTP `413`，请缩小图片和请求体后再试。统一 JSON 任务的 Base64 解码上限仍为 20 MiB，详见[错误处理与安全重试](/cn/getting-started/errors-and-retries)。

## quality 的含义

* `low`：较小输出预算，适合草稿类工作；
* `medium`：常规档位；
* `high`：最大公开输出预算；
* `auto`：由服务自动选择。

非法值会在生成前失败：

```json theme={"system"}
{
  "error": {
    "message": "quality must be one of: auto, low, medium, high",
    "type": "invalid_request_error",
    "code": "invalid_request"
  }
}
```

当前逆向接口每次返回一张结果，不承诺蒙版、流式 partial image、输出格式、透明背景、回调、取消和 SDK 专用调用。成功任务保持原生 ImagesResponse，图片在完成 24 小时后过期。

<Card title="运行 VIP 示例" icon="braces" href="/cn/models/image/gpt-image/gpt-image-2-vip/examples">
  复制三类受支持请求。
</Card>