跳转到主要内容

​
概述

gpt-image-2-all 是 API易 平台上线的一款 GPT 图像生成官逆模型。以 $0.03/张 的极具竞争力的按次计费定价，约 30 秒出图，支持 文生图 / 单图编辑 / 多图融合 / 自然语言改图，文字还原度高、内容限制少、原生支持中文提示词。
🎨 核心亮点：官逆通道稳定、定价统一每张 $0.03，无需关心 size/quality/n 等参数，尺寸与风格全部写进 prompt 即可——最适合”开箱即用”的图像生成场景。

文生图 API

输入文本提示词生成图片，带交互式 Playground 在线调试。

图片编辑 API

上传参考图 + 编辑/融合指令生成新图片（multipart/form-data）。

​
核心特性

极具竞争力定价

统一按次计费 $0.03/张，无分辨率阶梯，出图成本可预测

文字还原度高

图内中英文、招牌、海报文字还原稳定，适合信息图与营销物料

中文提示词友好

原生理解中文描述，无需翻译即可获得高质量输出

多图融合编辑

支持多张参考图同时输入，prompt 中可用「图1/图2/图3」指代

内容限制较少

相比部分官方模型，对创作类题材更宽松，出图成功率更高

R2 CDN 加速返回

默认返回 R2 CDN 链接，全球低延迟下载，可改为 b64_json

自然语言改图

支持通过对话描述直接改图，无需蒙版，可多轮迭代

三端点兼容

同时兼容 /images/generations、/images/edits、/chat/completions

​
模型定价

模型名计费方式价格输出
gpt-image-2-all按次计费$0.03 / 张单次返回 1 张图片
计费说明：
  • 统一定价，不区分分辨率、质量或提示词长度
  • 失败请求不计费（如鉴权失败、参数校验失败）
  • 如需生成 N 张，客户端并行调用 N 次

​
技术规格

维度参数
模型名gpt-image-2-all
渠道性质官方逆向（官逆）
定价$0.03 / 张，按次计费
出图速度约 30 秒
输出分辨率无显式 size 参数，由模型自适应（建议在 prompt 中描述）
默认响应格式url（R2 CDN 加速链接）
可选响应格式b64_json（已含 data:image/png;base64, 前缀）
中文提示词✅ 原生支持
支持能力文生图、单图编辑、多图融合、自然语言改图

​
端点一览

端点用途Content-Type
POST /v1/images/generations文生图application/json
POST /v1/images/edits图片编辑（单图/多图）multipart/form-data
POST /v1/chat/completions对话式（支持多轮 + 参考图）application/json
域名选择：api.apiyi.com 为主域名，也可使用 b.apiyi.com / vip.apiyi.com 等平台提供的其他网关域名，响应行为一致。

​
尺寸与比例控制

本模型没有 size 参数，尺寸通过 prompt 描述。经验证较稳定的写法：
需求推荐写法
方形1024×1024 方图 / 1:1 方形构图
横版横版 16:9 / 宽屏 16:9 电影画幅
竖版竖版 9:16 / 手机海报 9:16
超宽横幅横幅 21:9 超宽银幕
经典印刷4:3 标准画幅 / 3:2 经典画幅
技巧：在 prompt 开头 描述尺寸/构图，模型遵循度更高。可搭配画幅风格词（如 电影画幅、手机海报、方形构图）进一步提升一致性。

​
最佳实践

1

尺寸写在 prompt 开头

把比例、分辨率、画幅描述放在提示词最前面，模型遵循度更高。
2

大胆使用文字元素

该模型文字还原度是主要卖点，招牌、海报、信息图都可直接写中英文文字。
3

多图融合标注顺序

image[] 顺序有意义，在 prompt 里可用「图1/图2/图3」明确指代。
4

响应格式按需选择

Web 应用直接渲染用 b64_json，服务端中转存储用 url。
5

超时至少 120 秒

官方典型 30s，建议客户端超时设置 ≥120 秒以吸收长尾延迟。
6

不传无用字段

size、n、quality、aspect_ratio 不会生效，传入可能触发参数校验错误。

​
错误码与重试

状态码含义建议
401令牌无效检查 Bearer Token
429限流/额度不足指数退避重试
5xx网关/后端临时错误重试 1–2 次
超时官逆高峰偶发客户端设置 ≥120s 超时
建议客户端：
  • 请求超时 120 秒 起步（官方典型 30s，留 4x 余量吸收长尾）
  • 对 5xx 与超时做 指数退避重试（建议 2–3 次）
  • 记录响应头 request-id 方便排查

​
常见问题

本模型单次返回 1 张。如需 N 张，请客户端并行调用 N 次。每张独立按 $0.03 计费。
不要。本模型返回的 b64_json 字段已经带前缀，可直接赋给 HTML <img src> 或写入文件。如果你的代码沿用了”先拼前缀”的老逻辑，会产出损坏的 data URL，请先做 startsWith('data:') 检测。
自适应模型对尺寸描述是”参考”不是”强制”。提升遵循度的写法：把尺寸/画幅词放在 prompt 最前面，并配合画幅风格词（如 电影画幅、手机海报、方形构图）。
推荐 单张 ≤ 10MB，格式 png / jpg / webp。过大的图可能触发网关限制。多图融合时每张都需满足此限制。
本模型为一次性出图，不支持 stream 输出。如果对响应延迟敏感，建议客户端显示”生成中”进度提示，并合理配置 120s 超时。
可以。把 base_url 指向 https://api.apiyi.com/v1，api_key 设为 API易 令牌即可。但 client.images.generate() 方法默认带 size/n 参数——建议：
  • 使用 client.chat.completions.create() 方式调用；或
  • 直接用 requests / fetch 发原生 HTTP 请求。
本模型原生支持中文，两者效果接近。对中文特有的场景（如中式书法、传统节日元素）中文表达更自然。

​
相关文档

gpt-image-2-all 属于官逆通道，行为对齐但定价/能力与官方版本不完全一致。如需官方直连版本，请参考 GPT-Image-1.5。