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

> 查询 gpt-image-2-web 的文生图、单图或多图输入、三档尺寸、quality 转发、幂等提交和原生任务结果。

请求中的模型名固定为：

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

## 同步文生图

JSON 字段如下：

| 字段        | 取值                                         |
| --------- | ------------------------------------------ |
| `model`   | 必填，`gpt-image-2-web`                       |
| `prompt`  | 必填字符串                                      |
| `size`    | 明确传入 `1024x1024`、`2048x2048` 或 `3840x2160` |
| `n`       | 省略或使用 `1`                                  |
| `quality` | `low`、`medium`、`high`、`auto`，实际效果取决于所选上游   |

```json theme={"system"}
{
  "model": "gpt-image-2-web",
  "prompt": "浅色桌面上的蓝色陶瓷茶壶，产品摄影，不要文字",
  "size": "1024x1024",
  "quality": "high",
  "n": 1
}
```

将该请求体发送到 `/v1/images/generations`。

下游存储或排版依赖准确像素时，必须明确传入 `size`；当前公开接口不定义省略该字段后得到的像素尺寸。

## 统一异步请求

异步任务发送到 `/v1/images/tasks`。生图使用 `action=generate` 并省略 `input_images`；编辑可提供 1～16 张图片，下面用两张参考图组合画面：

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

`data` 只填写不带 data URL 前缀的 Base64；每张图解码后不超过 20 MiB，全部来源图合计不超过 64 MiB；`mime_type` 必须与 PNG、JPEG 或 WebP 文件字节一致。不要传 `aspect_ratio`。

可能重试的提交应设置最长 255 字节的 `Idempotency-Key`。同一键和请求体复用原任务，请求体变化时返回 HTTP `409`。

## 图生图表单

`POST /v1/images/edits` 使用 `multipart/form-data`：

* `model`、`prompt`、`image` 必填；
* `image` 可上传 PNG、JPEG 或 WebP；
* `size` 使用三档之一；
* `n` 省略或使用 `1`；
* `quality` 使用 `low`、`medium`、`high` 或 `auto`，效果取决于上游。

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

## 返回值

成功结果在 `data[0].b64_json`：

```json theme={"system"}
{
  "created": 1788307200,
  "data": [{"b64_json": "BASE64_IMAGE_DATA"}],
  "usage": {"input_tokens": 24, "output_tokens": 1756, "total_tokens": 1780}
}
```

Base64 解码后按 PNG 保存，不要等待 `url` 字段。

同步 Edit 只上传一张来源图，多图任务使用统一异步接口。当前逆向接口不开放蒙版、`n > 1`、partial image 流、输出格式与压缩、透明背景、回调和取消。成功任务保留原生 ImagesResponse，图片在完成 24 小时后过期。

<Card title="运行 Web 示例" icon="braces" href="/cn/models/image/gpt-image/gpt-image-2-web/examples">
  复制同步、异步和编辑代码。
</Card>