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 调用须知与最佳实践