GPT-Image-2.6-All 生圖/編輯

​

概述

• 價格：按次計費 $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 的獨佔能力
• 中文：原生支援中文提示詞，海報、招牌、資訊圖文字還原度高

​

快速開始

​

文生圖（curl）

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"
  }'

​

圖片編輯（Python，multipart）

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)

​

能力總表

​

尺寸

​

原生檔（≤1536，ChatGPT 網頁原生）

• 不要求 16 / 64 倍數；1537、1600x900、1920x1080 在原生檔會被拒。
• size=auto 由上游決定，實測 1312x1199、1402x1122、1448x1086 都出現過，不承諾固定值。
• 原生檔響應裡的 size 等於實際輸出尺寸。

​

超分檔（2K / 4K，大圖相容）

​

怎麼選

• 要 ChatGPT 原生質感 / 穩定畫質：size 控制在 1536 以內，1.5K 左右最佳；這是品質最可控的檔位，帶 ChatGPT 指紋。
• 要 2K 大圖相容：用 2048x2048、2048x1152、2048x1536，常見尺寸精確；圖更大，但不承諾細節多於 1.5K。
• 要 4K 橫圖：用 3840x2160，多數返回 3840x2160；偶發 4096x2731，以實際寬高為準。
• 要方形大圖：長邊上限 2880，4096x4096 會落到 2880x2880。
• 要 4:1 長條：不支援，4096x1024 會 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 動圖

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 向量

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，換提示詞重試。

​

錯誤碼

​

讓 AI Agent 幫你接入

​

常見問題

​

2K/4K 是原生解析度嗎？

​

為什麼 2K/4K 響應裡沒有 size？

​

能出 4K 透明底嗎？

​

GIF 能指定成片尺寸嗎？

​

支援 WebP 嗎？

​

quality 有用嗎？

​

為什麼 4096x1024 報錯？

​

相關文件

• 文生圖 API
• 圖片編輯 API
• GPT-Image-2.5-All 概覽
• 官轉 vs 官逆對比
• 圖片 API 呼叫須知與最佳實踐