跳转到主要内容

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-vip 是 API易 平台上线的 GPT 图像生成 Codex 官逆模型。与 gpt-image-2-all 同价 $0.03/张，调用方式完全一致，最大区别是 支持 size 参数——覆盖 10 比例 × 3 分辨率档（1K Fast / 2K Recommended / 4K Detail）共 30 档常见尺寸，含 4K。
🎨 核心定位：当你需要锁定输出尺寸（电商主图、海报模板、视频封面、4K 壁纸等）时使用 gpt-image-2-vip。请求体里只需把 model 改成 gpt-image-2-vip、加一个 size 字段，其它代码与 gpt-image-2-all 完全相同。

对话式 API

OpenAI Chat Completions 格式，同端点支持文生图与带图改图，方便直接传入在线图片 URL。

文生图 API

/v1/images/generations，输入文本提示词 + size 生成指定尺寸图片。

图片编辑 API

/v1/images/edits，multipart 上传参考图 + 编辑/融合指令。

​
与 gpt-image-2-all 的关键差异

gpt-image-2-vip 与 gpt-image-2-all 同属逆向通道、同价、同套调用代码。互相映射——把同一段请求里的 model 字段从一个换成另一个，行为整体一致，差异如下：
维度gpt-image-2-allgpt-image-2-vip
渠道逆向 ChatGPT 官网逆向 Codex 线路
价格$0.03 / 张$0.03 / 张（所有 size 统一价）
size 参数❌ 不接受（写进 prompt）✅ 30 档 size，含 4K
4K（如 3840x2160）❌✅ 4K Detail 档
出图速度约 30–60 秒约 90–150 秒（与官转 gpt-image-2 持平）
quality 参数❌ 不接受❌ 不接受（不要传）
支持端点/chat/completions + /images/generations + /images/edits同左（一模一样）
响应格式url / b64_json（已含前缀）同左
适合场景提示词驱动、对尺寸不敏感需要稳定指定输出尺寸（含 4K）
一句话决策：不需要严格控尺寸、追求出图速度 → gpt-image-2-all；要锁死输出尺寸或要 4K → gpt-image-2-vip；需要画质参数 quality 或 OpenAI 官方完全对齐的字段 → 改用官方版 gpt-image-2。

​
核心特性

稳定锁定输出尺寸

size 字段直接接受 30 档常见尺寸，电商主图、海报模板、4K 壁纸都能严格输出

4K 高分辨率

4K Detail 档支持 2880×2880 / 3840×2160 / 3840×1632 等，适合大尺寸交付物

所有 size 统一价

1K / 2K / 4K 所有档位统一 $0.03/张，4K 不额外加价

调用方式同 -all

请求结构、字段、响应字段与 gpt-image-2-all 完全一致，可秒级切换模型名

文字还原度高

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

中文提示词友好

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

自然语言改图

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

三端点兼容

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

​
模型定价

模型名计费方式价格输出
gpt-image-2-vip按次计费$0.03 / 张单次返回 1 张图片，size 字段锁定输出尺寸
计费说明：
  • 所有 30 档 size 统一定价 $0.03/张——4K Detail 不加价
  • 失败请求不计费（如鉴权失败、参数校验失败）
  • 如需生成 N 张，客户端并行调用 N 次

​
分组介绍

gpt-image-2-vip 放在 Default 默认分组 即可，不需要额外切分组。逆向通道目前供给稳定，不存在像官转那样需要”企业分组”过渡的场景。
模型分组备注
gpt-image-2-vipDefault逆向 Codex 线路，统一 $0.03/张，约 90–150 秒出图
gpt-image-2-vipimage2_OSS1x 倍率（不加价），确定性 URL 输出——默认分组资源紧张时不会降级为 base64

​
需要确定性 URL 输出 → 切到 image2_OSS 分组

gpt-image-2-vip（及 gpt-image-2-all）默认返回图片 url（R2 CDN 链接）。但当默认分组资源紧张时，为保证仍能出图，响应可能降级为 b64_json（base64 图片数据）而不是 URL。 如果你的业务强依赖 URL 输出（直接把 URL 落库、前端按 URL 渲染、不接受 base64），请把令牌分组切到 image2_OSS——这是专为 URL 输出确定性设计的分组，1x 倍率（不加价），对 gpt-image-2-vip 和 gpt-image-2-all 两个官逆模型都生效，保证响应稳定输出图片 URL，不会降级为 base64。
令牌创建界面：计费模式「按量优先」，选择分组 image2_OSS（1x 倍率），支持输出为图片 URL 的分组，适合 gpt-image-2-all 与 gpt-image-2-vip
进阶玩法（同时使用 gpt-image-2-all 与官转 gpt-image-2）：如果你的令牌同时覆盖逆向两模与官转 gpt-image-2，可以在令牌的「分组优先级」里这样配——
  • 第一优先级：image2Enterprise（1.2x 企业分组，官转专用稳定通道）
  • 默认（兜底）：Default（逆向两模都在这里，按模型路由）
这样官转 gpt-image-2 走企业分组保稳，逆向两模仍走默认分组——一把令牌覆盖三种模型，互不干扰。
📖 关于 image2Enterprise 企业分组：/live/2026-04/image2-enterprise

​
技术规格

维度参数
模型名gpt-image-2-vip
渠道性质官方逆向（逆向 Codex 线路）
定价$0.03 / 张，按次计费（所有 size 统一价）
出图速度约 90–150 秒（与官转 gpt-image-2 持平，慢于 gpt-image-2-all 的 30–60 秒）
size 参数✅ 30 档：10 比例 × 3 分辨率档（1K Fast / 2K Recommended / 4K Detail）
4K 支持✅ 4K Detail 档（如 3840x2160 / 2880x2880）
quality 参数❌ 不支持，不要传
n 参数❌ 不支持，单次仅返回 1 张
默认响应格式url（R2 CDN 加速链接，默认 1 天有效期）
可选响应格式b64_json（已含 data:image/png;base64, 前缀）
中文提示词✅ 原生支持
支持能力文生图、单图编辑、多图融合、自然语言改图（三端点皆可）
⏰ 图片 URL 有效期：默认 1 天默认响应的 url 字段是 R2 CDN 加速链接，有效期约 24 小时，过期后访问会 404。需要长期保存的图片请在生成后尽快转存到自己的对象存储 / CDN / 数据库，或改用 b64_json 响应格式。

​
端点一览

gpt-image-2-vip 与 gpt-image-2-all 兼容完全相同的三个端点。把 model 字段换掉、按需加上 size 即可：
端点用途Content-Type适用场景
POST /v1/chat/completions对话式（文生图 / 改图 / 多轮 / 参考图）application/json方便直接传入在线图片 URL；一个端点同时支持文生图与图片编辑
POST /v1/images/generations文生图application/jsonOpenAI Images API 标准格式，方便同一套代码同时调用官转与官逆
POST /v1/images/edits图片编辑（单图 / 多图）multipart/form-dataOpenAI Images API 标准格式，方便同一套代码同时调用官转与官逆
域名选择：api.apiyi.com 为主域名，也可使用 b.apiyi.com / vip.apiyi.com 等平台提供的其他网关域名，响应行为一致。

​
支持的 size（30 档完整对照表）

gpt-image-2-vip 支持 10 个比例 × 3 个分辨率档 = 30 档 常见尺寸。请求体直接传 size: "宽x高"（半角小写 x）。

​
1K Fast — 草稿与低成本试稿

比例命名像素
1:1Square1280x1280
2:3Portrait848x1280
3:2Photo1280x848
3:4Portrait960x1280
4:3Standard1280x960
4:5Social1024x1280
5:4Large1280x1024
9:16Story720x1280
16:9Wide1280x720
21:9Cinema1280x544
比例命名像素
1:1Square2048x2048
2:3Portrait1360x2048
3:2Photo2048x1360
3:4Portrait1536x2048
4:3Standard2048x1536
4:5Social1632x2048
5:4Large2048x1632
9:16Story1152x2048
16:9Wide2048x1152
21:9Cinema2048x864

​
4K Detail — 大尺寸交付物

比例命名像素
1:1Square2880x2880
2:3Portrait2336x3520
3:2Photo3520x2336
3:4Portrait2480x3312
4:3Standard3312x2480
4:5Social2560x3216
5:4Large3216x2560
9:16Story2160x3840
16:9Wide3840x2160
21:9Cinema3840x1632
30 档统一价：所有档位都是 $0.03/张，4K Detail 不额外加价。
怎么选档位：
  • 1K Fast：用于草稿、缩略图、A/B 测试，省时（也不省钱，价格统一），出图最快。
  • 2K Recommended：默认档，覆盖大部分终稿场景（电商主图、海报、信息图）。
  • 4K Detail：印刷、大屏壁纸、视频封面、桌面 / 户外大图。
最小调用示例（只传 size，不要传 quality）： 
curl "https://api.apiyi.com/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YI_API_KEY" \
  -d '{
    "model": "gpt-image-2-vip",
    "prompt": "生成一张白色陶瓷马克杯放在灰色桌面上的产品图，柔和自然光，简洁背景",
    "size": "2048x1360"
  }'

​
最佳实践

1

输入图先压到 1.5MB 以内（图生图 / 多图融合）

上传给接口的每张图先压到 1.5MB 以内（JPEG 质量 80-90 / 分辨率适当下调），多图融合时也按这个标准逐张控制。偶发的 shell_api_error / Unknown error 大多就是图片体积过大触发的，压一下请求成功率和出图速度都会明显改善。输出分辨率由 size 字段决定，与输入图体积无关——压小输入只会提速、不会损画质。提示词里光写 4K / 8K 这类词也不会真给你 4K，画质看 size，不看 prompt 修饰词。
2

按交付物档位选 size

草稿用 1K Fast、终稿用 2K Recommended、印刷/大屏用 4K Detail。所有档位统一价，按需要选。
3

size 用半角小写 x

请求体写 "size": "1536x1024"，不是 1536×1024、不是大写 X。
4

不要传 quality 与 n

quality 不接受；n 单次仅返回 1 张图，多张请客户端并行调用。
5

超时设到 300 秒

出图典型 90–150s，叠加图片上传/下载与高峰长尾，保守按 300s 配，避免大量误超时。
6

响应格式按需选择

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

代码可与 -all 共用

同一套调用代码，把 model 在 gpt-image-2-all ↔ gpt-image-2-vip 之间切换即可。需要锁尺寸时切到 -vip，需要更快出图时切回 -all。

​
错误码与重试

状态码含义建议
400size 取值不在 30 档内或格式错误用上表中的精确字符串
401令牌无效检查 Bearer Token
429限流/额度不足指数退避重试
500（4K 偶发）OpenAI 上游算力波动，4K Detail 档较易触发优先降到 2K Recommended 档重试；必须 4K 时改用官转 gpt-image-2 + image2Enterprise 企业分组
5xx（其它）网关/后端临时错误重试 1–2 次
超时Codex 高峰 + 4K 长尾客户端设置 ≥ 300s 超时（保守值）
建议客户端：
  • 请求超时 300 秒 起步（保守值；典型 90–150s，但 4K Detail + 高峰长尾会更长）
  • 对 5xx 与超时做 指数退避重试（建议 2–3 次）
  • 记录响应头 request-id 方便排查

​
常见问题

可以，几乎完全一样。 三个端点（/v1/chat/completions、/v1/images/generations、/v1/images/edits）的请求字段、响应字段、b64_json 前缀行为都一致。差异只有两处：
  1. model 字段：gpt-image-2-vip ↔ gpt-image-2-all
  2. size 字段：vip 接受 30 档常见尺寸；-all 不接受 size，尺寸要写进 prompt
实际工程实践：保留同一套代码，做一个 if model == 'vip': payload['size'] = ... 的开关即可。
gpt-image-2-vip 走的是 Codex 逆向通道，典型 90–150 秒，与官转 gpt-image-2（100–120 秒）持平，比 ChatGPT 网页线路的 gpt-image-2-all（约 30–60 秒）慢。如果对响应延迟敏感，建议优先用 gpt-image-2-all；只在必须锁尺寸或 4K 时切换到 vip。
是的，建议严格用表里 30 档之一。非表内 size 可能触发上游 invalid_request_error，请按交付需求选最接近的档位。
现象：在 4K Detail 档（如 3840x2160 / 2880x2880）较容易触发 status_code: 500 错误，上游返回 invalid_request_error：
{
  "status_code": 500,
  "error": {
    "message": "An error occurred while processing your request. ... Please include the request ID xxxxxxxx in your message.",
    "type": "invalid_request_error",
    "code": null
  }
}
根因：OpenAI 算力波动，与请求参数本身无关——同一段请求换 2K 档大概率就过了。Codex 官逆通道对 4K 这种大输出的负载更敏感，高峰期更明显。应对建议（按性价比排序）：
  1. 优先改用 2K Recommended 档（如 2048x1360 / 2048x2048）—— 2K 成功率显著更高，价格同样 $0.03/张
  2. 图生图 / 多图融合少传输入图 —— Codex 官逆链路对多入图请求处理压力大，会进一步增加 4K 失败率；单张输入图先压到 1.5MB 以内也有帮助
  3. 如必须稳定出 4K —— 切换到官转模型 gpt-image-2 + image2Enterprise 企业分组。官转 4K 价格更高（约 $0.3+/张），但稳定性显著更好，适合对 4K 交付有硬要求的场景。
📖 经验来源：/live/2026-05/gpt-image-2-vip-4k-tips
强烈建议压。单张输入图压到 1.5MB 以内（JPEG 质量 80-90 / 分辨率适当下调）：偶发的 shell_api_error / Unknown error 大多就是图片体积过大触发的，压一下请求成功率和出图速度都会明显改善。注意 1.5MB 是推荐上限（追求稳定性与速度），上面 FAQ 写的 10MB 是网关硬上限。别担心压输入会损画质——本模型输出分辨率由 size 参数决定，跟你上传图的体积没关系。压小输入只会提速、不会损画质。提示词里光写 4K / 8K 这类词也不会真给你 4K。如果 prompt 写 8K 超清 但 size 选 1024x1024，最终拿到的就是 1K 水平。要 4K 请在 size 字段里指定——30 档里 1K / 2K / 4K 同价 $0.03/张，按需要直接选。📖 排错来源：/live/2026-05/gpt-image-2-vip-unknown-error
不加价，4K Detail 档（3840x2160 / 2880x2880 等）与 1K / 2K 同价 $0.03/张。
不支持。 本模型单次只返回 1 张图，请通过重复调用 / 并发调用的方式生成多张。⚠️ 重要：如果在请求里传入 n=3，计费会按 0.03 × 3 = $0.09 扣费，但实际上仍然只返回 1 张图。请务必把 n 字段从请求里去掉，避免被多扣费。
官逆是同步对话式返回，结果分两种情况，计费规则不同：1) 返回 5xx 状态码 → 不计费上游内容策略明确拦截时会返回类似：
{
  "error": {
    "message": "没有按照预期生成图片，请重新调整提示词后重试（traceid: 0672821c6951af183dbf847130caaf16）",
    "localized_message": "Unknown error",
    "type": "invalid_request_error",
    "param": "",
    "code": null
  }
}
这种”明确报错”调用不计费，引导用户调整提示词重试即可。2) 返回 200 状态码（模型用文字软拒绝）→ 计费模型在对话里软拒绝、用文字回复（例如「我不能做到这个需求」「抱歉，这个请求涉及……」），从协议层看就是一次正常的对话返回，这种情况会被计费。官逆目前没有办法在协议层提前识别”这一段是拒绝文字而不是图片”。为什么不能直接对软拒绝免单？强行对所有”软拒绝”都不计费意味着平台要为每次失败承担上游成本；更关键的是，频繁触发上游内容安全会让供应方账号更容易被封号——这部分供给侧的硬成本也无法完全规避。给接入方的建议
  • ✅ 前置内容过滤 / 风险提示：在前端或接入层先做一道关键词与场景过滤（如真实姓名、版权角色、敏感题材），并在 UI 上提示”涉及名人/版权题材时上游限制较严，可能失败也会计费”，能显著降低误扣率。
  • ✅ C 端产品月度补发：理解 C 端产品无法完全控制用户输入。如果你的月用量较大（月消费 $1000+ 起），可以按月汇总日志（短耗时调用通常对应软拒绝）联系客服一次性人工补发，无须逐条申诉。
📖 相关：官逆 500 多为内容违规
不要。本模型返回的 b64_json 字段已经带前缀，可直接赋给 HTML <img src> 或写入文件。如果你的代码沿用了”先拼前缀”的老逻辑，会产出损坏的 data URL，请先做 startsWith('data:') 检测。
推荐 单张 ≤ 10MB，格式 png / jpg / webp。过大的图可能触发网关限制。多图融合时每张都需满足此限制。
默认响应的 url 字段是 R2 CDN 加速链接，有效期约 1 天（24 小时），过期后会 404。强烈建议：生成后尽快把图片 转存到自己的对象存储（S3 / OSS / R2）、CDN 或数据库，不要长期直接引用本服务返回的 URL。
本模型为一次性出图，不支持 stream 输出。如果对响应延迟敏感，建议客户端显示”生成中”进度提示，并合理配置 300s 超时（保守值）。
可以。把 base_url 指向 https://api.apiyi.com/v1，api_key 设为 API易 令牌即可。client.images.generate(model="gpt-image-2-vip", size="2048x1360", prompt=...) 直接可用。
需要 quality（low/medium/high）档位、需要 mask 局部重绘、需要 OpenAI 官方完全一致的字段行为时，改用 gpt-image-2（官转）。详见 官转 vs 官逆 对比。

​
相关文档

gpt-image-2-vip 属于官逆通道（Codex 线路），行为对齐但定价/能力与官方版本不完全一致。需要官方完全一致字段时，请使用 gpt-image-2。