> ## 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/zh-Hant/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/zh-Hant/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/zh-Hant/api-capabilities/gpt-image-2-all/text-to-image.md)
* [圖片編輯 API](https://docs.apiyi.com/zh-Hant/api-capabilities/gpt-image-2-all/image-edit.md)
* [GPT-Image-2.5-All 概覽](https://docs.apiyi.com/zh-Hant/api-capabilities/gpt-image-2-all/overview.md)
* [官轉 vs 官逆對比](https://docs.apiyi.com/zh-Hant/api-capabilities/gpt-image-2/vs-gpt-image-2-all.md)
* [圖片 API 呼叫須知與最佳實踐](https://docs.apiyi.com/zh-Hant/api-capabilities/image-api-best-practices.md)


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