GPT-Image-2.6-All 生图/编辑

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

图片 API 全部为同步调用：没有异步任务 ID，客户端断开连接结果即丢失、但请求仍会计费。请为本模型设置足够大的 timeout（建议 600 秒），详见 图片 API 调用须知与最佳实践。

​

概述

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 秒，尾延迟可到 3 分钟）
• 画质：长边 512–1536 为原生档，ChatGPT 网页画质与指纹最可控；2K/4K 为超分放大，只解决大图尺寸，不承诺比 1.5K 更清晰
• 格式：PNG / JPEG / GIF / SVG，支持透明底与 24 小时 URL；GIF / SVG 是这条线相对 2.5-all 的独占能力
• 中文：原生支持中文提示词，海报、招牌、信息图文字还原度高

模型价格与官网对齐，且可能随官网调整；本页价格仅供参考，具体以顶部导航「模型价格」栏目为准：模型价格。

GIF 动图

output_format=gif 原生输出；帧数与时长精确，尺寸由上游决定。

SVG 矢量

output_format=svg 真矢量，viewBox 跟随 size，2K–8K。

ChatGPT 原生画质

1536 以内保留 ChatGPT 网页版的质感与指纹，质量最可控。

2K/4K 大图兼容

超分放大，常见尺寸精确；图更大，但不等于细节更多。

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

​

快速开始

​

文生图（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"
  }'

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

​

图片编辑（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)

​

能力总表

能力	支持情况	说明
文生图	✅	/v1/images/generations
图片编辑	✅	单图 / mask / 多图参考，/v1/images/edits
size	✅	长边 512–1536 原生；2K/4K 超分
ChatGPT 原生画质（带指纹）	✅ ≤1536	2K/4K 超分后不承诺原生细节/指纹
n	✅ 1–4	按张计费；实测 2K n=4 返回四张，n=5 起 400
输出格式	✅ 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 分组直接可用
响应 size	✅ b64 / ⚠️ url	b64 回显实际尺寸；url 响应可能没有
方形大图	✅ ≤2880	超过 2880 返回 502 size_not_deliverable
quality	✅ auto/medium/high	low / hd 会 400；不建议依赖画质差异
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	200 精确；不匹配时 502	4K 16:9；可重试或改用支持尺寸
2880x2880	2880x2880	方形上限，直接请求即可
4096x4096 / 3840x3840 / 3200x3200	502 size_not_deliverable	上游 2880；方形大图请直接请求 2880x2880
1152x2048	200 精确；不匹配时 502	上游偶发 1365x2048，不静默归整
4096x1024	400	超过 3:1，直接拒绝
3840x2160 + 透明底	200 精确 / 502	上游偶发 4096 长边；建议透明底 ≤2K

2K/4K 的 b64 响应会回显 size；url 响应可能没有。尺寸不匹配时返回 502 size_not_deliverable，不会静默改尺寸。请以响应 size 和图片实际宽高为准。

​

怎么选

• 要 ChatGPT 原生质感 / 稳定画质：size 控制在 1536 以内，1.5K 左右最佳；这是质量最可控的档位，带 ChatGPT 指纹。
• 要 2K 大图兼容：用 2048x2048、2048x1152、2048x1536，常见尺寸精确；图更大，但不承诺细节多于 1.5K。
• 要 4K 横图：用 3840x2160，多数精确；不匹配时 502，可重试或改用支持尺寸。
• 要方形大图：直接请求 2880x2880；4096x4096 / 3840x3840 / 3200x3200 会 502。
• 要 4K 透明底：可能 200 精确，也可能 502；建议透明底 ≤2K。
• 要 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。b64 响应回显 size；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–4，按张计费。实测 2K n=2 两张、n=3 三张（output_image_tokens=8160）、n=4 四张（10880）；n=5 起 400 n must be an integer between 1 and 4。按 $0.025/张 的口径，n=3 为 $0.075、n=4 为 $0.10，最终以账单为准。
• 默认返回 b64_json；传 response_format=url 时只回 url，两者不并存。
• 响应常见字段：created、data[]、usage；b64 响应回显 size，url 响应可能缺失，需读实际宽高。
• URL 是 24 小时签名链接，过期后需要重新生成。

​

超时与并发

• 客户端超时建议 600 秒：1K 约 10–22 秒、2K 约 12–24 秒、4K 约 15–42 秒，尾延迟可到 3 分钟（1000x1000 实测 198 秒）。反向代理、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 透明底不稳定：实测可能 200 精确 3840x2160，也可能 502（上游 4096 长边）；透明底建议 ≤2K。
• quality 只接受 auto / medium / high：low / hd 会 400；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	内容安全拒绝	换提示词
400	quality ... is not supported by this route	quality 只支持 auto/medium/high	改 quality
400	n must be an integer between 1 and 4	n 超出 1–4	改 n
401	invalid_api_key	Key 错误或分组不对	检查 APIYI_API_KEY 与 Default 分组
429	rate_limit_exceeded	并发/额度限流	退避重试
502	size_not_deliverable	2K/4K 尺寸无法精确交付	改用支持尺寸或重试
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 条接入要求，点下方按钮复制完整版

已复制复制提示词

这段提示词替你挡掉了什么

要求	挡掉的坑
timeout 600 秒	主流 HTTP 客户端默认 30–60 秒超时，会在服务端还在正常出图时掐断请求，而断连的请求照常计费
显式 response_format	默认值历史上变过；不显式指定就得同时兜住 url 和 b64_json 两种形态
读响应 size / 实际宽高	b64 回显 size，url 可能没有；尺寸不匹配会 502，不静默改尺寸
GIF 必须带格式	不传 output_format=gif 会 502，错误文案也不好读
透明底 ≤2K	4K 透明底可能 200 精确，也可能 502；建议 ≤2K
不传 WebP	只支持 PNG / JPEG / GIF / SVG，传 WebP 直接 400

​

常见问题

​

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

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

​

为什么有时没有 size？

b64 响应会回显 size，url 响应可能没有；尺寸不匹配时返回 502 size_not_deliverable。请以响应 size 和图片实际宽高（如 PNG 的 IHDR）为准。

​

能出 4K 透明底吗？

可能精确，也可能 502。2K 透明底实测稳定（RGBA，全透明像素约 40%）；4K 透明底实测有 200 精确 3840x2160 的情况，也有上游 4096 长边导致 502 的情况，不要写死一定能出。需要透明底建议 ≤2K。

​

GIF 能指定成片尺寸吗？

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

​

支持 WebP 吗？

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

​

quality 有用吗？

只接受 auto / medium / high；low / hd 会返回 400。medium / high 实测 2048x2048，目前没有可验证的同 seed 画质差异。

​

为什么 4096x4096 报错？

方形上游上限是 2880；4096x4096、3840x3840、3200x3200 都会返回 502 size_not_deliverable（上游给的是 2880x2880）。需要方形大图请直接请求 2880x2880。

​

n 最大能传多少？

1–4。传 5 及以上会 400 n must be an integer between 1 and 4；传 0 会 400 n must be greater than 0。按张计费，n=4 就是 4 张的钱。

​

为什么 4096x1024 报错？

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

​

相关文档

• 文生图 API
• 图片编辑 API
• GPT-Image-2.5-All 概览
• 官转 vs 官逆对比（2.6） - 与 gpt-image-2.6-flare / sunburst 的选型对照
• 图片 API 调用须知与最佳实践