> ## 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-2.6-All 生图/编辑

> GPT 图像生成 ChatGPT 网页版官逆模型 gpt-image-2.6-all，$0.025/张按次计费，约 10–46 秒出图；1536 以内为 ChatGPT 原生画质（带指纹），原生支持 GIF / SVG，2K/4K 为超分大图兼容，另有透明底与多图编辑。

> [!NOTE]
>
> 图片 API 全部为**同步调用**：没有异步任务 ID，客户端断开连接结果即丢失、但请求仍会计费。请为本模型设置足够大的 timeout（建议 600 秒），详见 [图片 API 调用须知与最佳实践](https://docs.apiyi.com/api-capabilities/image-api-best-practices.md)。

## 概述

**gpt-image-2.6-all** 是 API易 平台的 **GPT 图像生成官逆模型**，逆向 ChatGPT 网页版 Images 2.6。和只靠提示词描述尺寸的旧 `-all` 线路不同，2.6 这条线**真正接受 `size`、`n`、`background` 与 `output_format`**，还能出 GIF、SVG 和多图编辑，适合需要把尺寸、格式、张数写进代码的生产场景。

这条线最值得用的是三件事：**GIF、SVG、1536 以内的 ChatGPT 原生画质（带指纹）**。2K/4K 是为大图兼容准备的**超分档**——尺寸更大，但不等于细节更多；对画质有要求时，优先 1.5K 左右的原生档。

统一使用 OpenAI Images API 标准端点：`POST /v1/images/generations`（文生图）与 `POST /v1/images/edits`（图片编辑）。

* **价格**：按次计费 **\$0.025/张**，2K/4K 不额外加价
* **速度**：约 **10–46 秒**（1K 10–22 秒，2K 12–24 秒，4K 15–42 秒，尾延迟可到 60 秒以上）
* **画质**：长边 **512–1536 为原生档**，ChatGPT 网页画质与指纹最可控；**2K/4K 为超分放大**，只解决大图尺寸，不承诺比 1.5K 更清晰
* **格式**：PNG / JPEG / GIF / SVG，支持透明底与 24 小时 URL；**GIF / SVG 是这条线相对 2.5-all 的独占能力**
* **中文**：原生支持中文提示词，海报、招牌、信息图文字还原度高

> [!NOTE]
>
> 模型价格与官网对齐，且可能随官网调整；本页价格仅供参考，具体以顶部导航「模型价格」栏目为准：[模型价格](https://docs.apiyi.com/models/index.md)。

> [card] GIF 动图
>
> `output_format=gif` 原生输出；帧数与时长精确，尺寸由上游决定。

> [card] SVG 矢量
>
> `output_format=svg` 真矢量，`viewBox` 跟随 `size`，2K–8K。

> [card] ChatGPT 原生画质
>
> 1536 以内保留 ChatGPT 网页版的质感与指纹，质量最可控。

> [card] 2K/4K 大图兼容
>
> 超分放大，常见尺寸精确；图更大，但不等于细节更多。

> [!NOTE]
>
> **2K/4K 怎么定位**：给海报、印刷、大屏等**需要更大画布**的场景用；它不是「更清晰的 1.5K」，细节不一定多于原生档。要稳定画质，优先 **1536 以内（1.5K 左右）**。

## 快速开始

### 文生图（curl）

```bash theme={null}
curl https://api.apiyi.com/v1/images/generations \
  -H "Authorization: Bearer $APIYI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-all",
    "prompt": "一张米色纸张质感的秋日读书会海报，中央竖排标题「秋日读书会」，右下角手绘枫叶",
    "size": "1536x1024",
    "response_format": "b64_json"
  }'
```

默认返回 `b64_json`（纯 base64，不带 `data:` 前缀）。需要直链时传 `"response_format": "url"`，链接约 24 小时后失效，服务端要及时转存。

### 图片编辑（Python，multipart）

```python theme={null}
import base64
import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["APIYI_API_KEY"],
    base_url="https://api.apiyi.com/v1",
    timeout=600,
)

with open("input.png", "rb") as f:
    result = client.images.edit(
        model="gpt-image-2.6-all",
        image=f,
        prompt="把背景换成浅灰色，保留主体和文字",
        size="1536x1024",
    )

image_bytes = base64.b64decode(result.data[0].b64_json)
with open("edited.png", "wb") as f:
    f.write(image_bytes)
```

## 能力总表

| 能力 | 支持情况 | 说明 |
| - | - | - |
| 文生图 | ✅ | `/v1/images/generations` |
| 图片编辑 | ✅ | 单图 / mask / 多图参考，`/v1/images/edits` |
| `size` | ✅ | 长边 512–1536 原生；2K/4K 超分 |
| ChatGPT 原生画质（带指纹） | ✅ ≤1536 | 2K/4K 超分后不承诺原生细节/指纹 |
| `n` | ✅ 1–10 | 按张计费；实测 2K `n=2` 返回两张 |
| 输出格式 | ✅ PNG / JPEG / GIF / SVG | **WebP 不支持**，传了会 400 |
| 透明底 | ✅ 2K 以内 | `background=transparent` + PNG；4K 不稳定 |
| GIF | ✅ | 必须显式 `output_format=gif`；`size` 不保证 |
| SVG | ✅ | 2K–8K，`viewBox` 跟随 |
| URL 返回 | ✅ | `response_format=url`，Default 分组直接可用 |
| `quality` | ⚠️ 接受 | `low` 在 2K 可能输出 2048x1153；不建议依赖 |
| mask | ⚠️ 接受 | 不承诺只改蒙版区，复杂局部修改建议写清指令 |

## 尺寸

### 原生档（≤1536，ChatGPT 网页原生）

| 比例 | 常见 `size` |
| - | - |
| 1:1 | 512x512、768x768、896x896、1000x1000、1024x1024、1536x1536 |
| 4:3 / 3:4 | 1024x768、1536x1152、768x1024、1152x1536 |
| 3:2 / 2:3 | 1024x683、1536x1024、683x1024、1024x1536 |
| 16:9 / 9:16 | 1280x720、1536x864、720x1280、864x1536 |
| 3:1 / 1:3 | 1536x512、512x1536 |
| 非标准 | 长边 512–1536、比例 ≤3:1 内任意整数，精确输出 |

* 不要求 16 / 64 倍数；`1537`、`1600x900`、`1920x1080` 在原生档会被拒。
* `size=auto` 由上游决定，实测 1312x1199、1402x1122、1448x1086 都出现过，**不承诺固定值**。
* 原生档响应里的 `size` 等于实际输出尺寸。

### 超分档（2K / 4K，大图兼容）

2K/4K 通过超分把长边放大到 2048/4096，适合需要更大画布的场景。**尺寸更大不等于细节更多**——它不是原生像素，也不承诺比 1536 原生档更清晰。常见尺寸实测如下：

| 请求 `size` | 实测输出 | 说明 |
| - | - | - |
| 2048x2048 | 2048x2048 | 2K 方图 |
| 2048x1152 | 2048x1152 | 16:9 |
| 2048x1536 | 2048x1536 | 4:3 |
| 1920x1080 | 1920x1080 | 精确 |
| 1600x900 / 3000x2000 | 精确 | — |
| 2000x2000 / 1792x1024 / 1024x1792 | 精确 | — |
| 3840x2160 | 3840x2160（多数）/ 4096x2731（偶发） | 4K 16:9 |
| 4096x4096 / 3840x3840 / 3200x3200 | 2880x2880 | 方形上限 2880 |
| 1152x2048 | 1152x2048（多数）/ 1365x2048（偶发） | 9:16 偶发归整 2:3 |
| 4096x1024 | **400** | 超过 3:1，直接拒绝 |
| 3840x2160 + 透明底 | 4096 长边的不同高度 | **不跟随 size**，不要承诺 |

> [!WARNING]
>
> 2K/4K 响应**可能不回显 `size` 字段**，也可能因比例归整出现 `1365x2048`、`4096x2731` 等结果。**请始终读取图片实际宽高再验收**，不要用请求的 `size` 当作返回值。

### 怎么选

* **要 ChatGPT 原生质感 / 稳定画质**：`size` 控制在 **1536 以内**，1.5K 左右最佳；这是质量最可控的档位，带 ChatGPT 指纹。
* **要 2K 大图兼容**：用 `2048x2048`、`2048x1152`、`2048x1536`，常见尺寸精确；图更大，但不承诺细节多于 1.5K。
* **要 4K 横图**：用 `3840x2160`，多数返回 3840x2160；偶发 4096x2731，以实际宽高为准。
* **要方形大图**：长边上限 **2880**，`4096x4096` 会落到 2880x2880。
* **要 4:1 长条**：不支持，`4096x1024` 会 400。

## 格式

| 格式 | 请求 | 说明 |
| - | - | - |
| PNG | 默认 | 支持透明底；无损 |
| JPEG | `output_format=jpeg` | 体积更小；透明底会失败 |
| GIF | `output_format=gif` | 必须同时给帧参数；尺寸由上游决定 |
| SVG | `output_format=svg` | 真矢量，`viewBox` 跟随 `size` |
| WebP | ❌ | 返回 400，不要传 |

* **透明底**：`background=transparent` + PNG。2K 以内实测 RGBA，全透明像素约 40%；**4K 透明底不跟随 `size`，不承诺尺寸**。
* **URL**：`response_format=url` 在 `Default` 分组直接可用，不需要 `Image2_OSS` 分组；链接是 24 小时签名 URL。
* **WebP 不支持**：错误文案是 `output_format 'webp' is not supported; use png, jpeg, gif or svg`。

## GIF 动图

```bash theme={null}
curl https://api.apiyi.com/v1/images/generations \
  -H "Authorization: Bearer $APIYI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-all",
    "prompt": "生成一段黄色玩偶皱眉、鼓腮、跺脚的循环动图，纯白背景，无缝循环。",
    "size": "2048x2048",
    "output_format": "gif",
    "frame_count": 8,
    "frame_duration_ms": 150
  }'
```

* **必须显式传 `output_format=gif`**。只写「循环动图」而不传格式时，兼容层按 PNG 收图，会返回 502 `image 1 is gif, png was asked for`。
* `frame_count` / `frame_duration_ms` 实测精确：8 帧 / 150 ms、4 帧 / 300 ms、6 帧 / 120 ms 都与请求一致。
* **`size` 不保证成片尺寸**：1K 档实测 384x512、507x506、619x623；2K 档 327x585；4K 档 621x621。**只承诺帧数与时长，不承诺像素尺寸。**
* 要固定 GIF 尺寸，目前没有可靠参数；请在客户端拿到 GIF 后自行缩放/裁切。

## SVG 矢量

```bash theme={null}
curl https://api.apiyi.com/v1/images/generations \
  -H "Authorization: Bearer $APIYI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-all",
    "prompt": "一枚扁平风格的火箭图标，正好三种颜色，无文字",
    "size": "2048x2048",
    "output_format": "svg"
  }'
```

* **真矢量**：返回 `<svg>` 文本，不是位图；实测 2048²、3840x2160、4096²、6144²、8192² 都通过。
* **`viewBox` 跟随 `size`**：请求 2048x2048 得到 `viewBox="0 0 2048 2048"`，请求 3840x2160 得到 `viewBox="0 0 3840 2160"`。
* **不需要 `svg` 对象**：传 `output_format=svg` 即可。官转或部分 SDK 会顺手带上 `"svg": {"model": "..."}`，2.6-all **接受但不解析这个字段**，传了不会报错、也不会改变结果，不需要依赖它。
* 返回内容不含 `<script>` 与内嵌位图；如需二次编辑，直接按 `viewBox` 坐标处理。

## 图片编辑

* **端点**：`POST /v1/images/edits`，`multipart/form-data`。
* **单图 / mask / 多图**都接受；mask 传入后会作为参考，但**不承诺只改蒙版区**，复杂局部修改建议在提示词里写清「只改哪里、保留哪里」。
* **指定 `size` 时精确**：2K/4K 也实测精确（2048x2048、3840x2160）。
* **不传 `size` 或 `auto`**：输出会归一到约 **1.57 MP** 并保持原图长宽比，不保证原图像素尺寸。
* 多图参考实测 2 张可用；更多张建议先在客户端拼图或分步编辑，避免单次请求过重。

## `n` 与返回

* `n` 支持 **1–10**，按张计费。实测 2K `n=2` 返回两张 2048x2048；`n=3` 返回三张，`usage.image_count=3`、`output_image_tokens=8160`（3 × 2720），按 \$0.025/张 的口径就是 \$0.075，最终以账单为准。
* 默认返回 `b64_json`；传 `response_format=url` 时只回 `url`，两者不并存。
* 响应常见字段：`created`、`data[]`、`usage`；**2K/4K 的 `size` 可能缺失**，1K 档通常会回显。
* URL 是 24 小时签名链接，过期后需要重新生成。

## 超时与并发

* **客户端超时建议 600 秒**：1K 约 10–22 秒、2K 约 12–24 秒、4K 约 15–42 秒，尾延迟可到 60 秒以上。反向代理、Serverless、队列消费都要一起放宽。
* **并发**：1K 档实测 12×2、16×1、8×1536 全部通过，无 429；2K/4K 未做并发压测，建议先从 4–8 路起，观察尾延迟后再加。
* **同步计费**：请求发出即计费，客户端断连不退款、也不保留结果。

## 边界与限制

* **2K/4K 是超分放大**：用于大图兼容，细节不一定多于 1536 原生档；要稳定画质请用 1536 以内。
* **2K/4K 依赖兜底通道**：请求先走原生线路，尺寸超出时由平台换线到超分线路；极少数情况下兜底不可用会返回 400 `wide_fallback_required`，重试或改用 1536 以内。
* **GIF 尺寸不保证**：1K / 2K / 4K 都可能输出小图，只承诺帧数与时长。
* **WebP 不支持**：只支持 PNG / JPEG / GIF / SVG。
* **4:1 比例不支持**：`4096x1024` 会 400，最大比例 3:1。
* **4K 透明底不稳定**：实测 4096 长边的多种高度，不要承诺 3840x2160；透明底建议 ≤2K。
* **`quality` 不要依赖**：接受 `low` / `medium` / `high`，但 `low` 在 2K 可能输出 2048x1153，`medium` / `high` 为 2048x2048；画质差异未做同 seed 盲评。
* **编辑 `auto` 会缩放**：输出约 1.57 MP，不是原图尺寸。
* **内容策略**：触发上游内容安全时会返回 400 `content_policy_violation`，换提示词重试。

## 错误码

| HTTP | `code` | 含义 | 处理 |
| - | - | - | - |
| 400 | `invalid_request_error` | 参数非法（size 格式、比例、格式） | 按提示改参数 |
| 400 | `wide_fallback_required` | 2K/4K 兜底通道暂不可用 | 重试；或改用 ≤1536 |
| 400 | `content_policy_violation` | 内容安全拒绝 | 换提示词 |
| 401 | `invalid_api_key` | Key 错误或分组不对 | 检查 `APIYI_API_KEY` 与 Default 分组 |
| 429 | `rate_limit_exceeded` | 并发/额度限流 | 退避重试 |
| 502 | `image 1 is gif, png was asked for` | GIF 未传 `output_format=gif` | 显式传 `output_format=gif` |

## 让 AI Agent 帮你接入

**复制这段提示词，粘贴给 Codex / Claude Code / Cursor**

它会先抓本页的纯文本版（任意文档页地址后加 `.md`），再按你项目的技术栈写代码——超时、2K/4K 验收、GIF 格式、WebP 限制这几个高频坑已经写死在要求里。

共 9 条接入要求，点下方按钮复制完整版

帮我在当前项目里接入 / 排查 gpt-image-2.6-all 的「文生图 + 图片编辑」。

先读文档再动手：抓 [https://docs.apiyi.com/api-capabilities/gpt-image-2-all/gpt-image-2-6-all.md](https://docs.apiyi.com/api-capabilities/gpt-image-2-all/gpt-image-2-6-all.md) 拿到本页纯文本版；需要更细的参数说明时，text-to-image 和 image-edit 两页同样在地址后加 `.md` 即可。

接入要求：

1. 超时：客户端 timeout 提到 600 秒。图片接口是同步调用，没有任务 ID，客户端一断连结果就丢了、但这次请求照样计费，所以宁可多等也不要过早超时。反向代理、网关、Serverless 执行上限这些中间层也要一起放宽。

2. 返回渲染：默认返回 base64（`b64_json`，不带 `data:` 前缀），也可以显式传 `response_format: "url"` 拿 24 小时签名直链。**请显式传 `response_format`，不要依赖默认值**；走 url 要在服务端立即下载转存。

3. 尺寸：长边 512–1536 是原生档，任意整数、比例不超过 3:1；2K/4K 是超分大图兼容，不是原生像素。**2K/4K 响应可能不回显 `size`，必须读图片实际宽高再验收**；`4096x1024` 这类超过 3:1 的比例会 400。

4. GIF：必须显式传 `output_format=gif`，再传 `frame_count` / `frame_duration_ms`；**`size` 不保证成片尺寸**，不要用 `size` 控制 GIF 像素。

5. SVG：传 `output_format=svg` 即可，`viewBox` 跟随 `size`，不需要额外的 `svg` 对象；返回的是真矢量，不是位图。

6. 透明底：`background=transparent` + PNG，建议 ≤2K；4K 透明底尺寸不稳定，不要承诺 3840x2160。

7. `n` 支持 1–10，按张计费；`quality` 接受但不要依赖，`low` 在 2K 可能输出 2048x1153。

8. Key 从环境变量 `APIYI_API_KEY` 读，base\_url 用 [https://api.apiyi.com/v1，不要硬编码进代码、也不要提交进](https://api.apiyi.com/v1，不要硬编码进代码、也不要提交进) git。

9. 改完真跑一次文生图 + 一次图片编辑，把实际宽高、耗时和两次调用花费贴给我。

> [accordion] 这段提示词替你挡掉了什么
>
> | 要求 | 挡掉的坑 |
> | - | - |
> | timeout 600 秒 | 主流 HTTP 客户端默认 30–60 秒超时，会在服务端还在正常出图时掐断请求，而断连的请求照常计费 |
> | 显式 `response_format` | 默认值历史上变过；不显式指定就得同时兜住 `url` 和 `b64_json` 两种形态 |
> | 读实际宽高 | 2K/4K 可能不回显 `size`，9:16 偶发归整为 1365x2048，4K 偶发 4096x2731 |
> | GIF 必须带格式 | 不传 `output_format=gif` 会 502，错误文案也不好读 |
> | 透明底 ≤2K | 4K 透明底实测会漂到 4096 长边，尺寸不可控 |
> | 不传 WebP | 只支持 PNG / JPEG / GIF / SVG，传 WebP 直接 400 |

## 常见问题

### 2K/4K 是原生分辨率吗？

不是。2K/4K 是超分放大，解决的是尺寸/大图兼容，不是原生细节；原生画质在 1536 以内，带 ChatGPT 指纹。要稳定画质优先 1.5K 左右，要海报/印刷大图再用 2048–3840。

### 为什么 2K/4K 响应里没有 `size`？

2K/4K 由超分线路交付，该线路不一定回显 `size`；1K 档通常会回显。请读取图片实际宽高（如 PNG 的 IHDR）再验收，不要用请求的 `size` 当返回值。

### 能出 4K 透明底吗？

不承诺。2K 透明底实测稳定（RGBA，全透明像素约 40%）；4K 透明底实测会返回 4096 长边的不同高度（4096x4096、4096x3552、4096x2731 都出现过），不要写死 3840x2160。需要透明底建议 ≤2K。

### GIF 能指定成片尺寸吗？

不能。`size` 对 GIF 不生效：1K 档常见 384x512 / 507x506 / 619x623，2K 档 327x585，4K 档 621x621。只承诺帧数与时长；要固定像素请在客户端后处理。

### 支持 WebP 吗？

不支持。只支持 PNG / JPEG / GIF / SVG；传 `output_format=webp` 会返回 400。

### `quality` 有用吗？

接受 `low` / `medium` / `high`，但不要依赖：`low` 在 2K 可能输出 2048x1153，`medium` / `high` 为 2048x2048；目前没有可验证的同 seed 画质差异。

### 为什么 `4096x1024` 报错？

最大长宽比是 3:1，`4096x1024` 是 4:1，会在参数校验阶段直接 400。需要长条图请改用 `4096x1536` 以内的比例，或分两张拼接。

## 相关文档

* [文生图 API](https://docs.apiyi.com/api-capabilities/gpt-image-2-all/text-to-image.md)
* [图片编辑 API](https://docs.apiyi.com/api-capabilities/gpt-image-2-all/image-edit.md)
* [GPT-Image-2.5-All 概览](https://docs.apiyi.com/api-capabilities/gpt-image-2-all/overview.md)
* [官转 vs 官逆对比](https://docs.apiyi.com/api-capabilities/gpt-image-2/vs-gpt-image-2-all.md)
* [图片 API 调用须知与最佳实践](https://docs.apiyi.com/api-capabilities/image-api-best-practices.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.