图片 / GPT 4K 与重建
GPT基地 + 香蕉重建 2K / 4K
先由 GPT Image 2.5 生成约 1K 原图，再由香蕉 2.0、2.1 或 Pro 按原图重建为 1K / 2K / 4K，客户端只需调用一次。按张计费、各分辨率同价，任一阶段失败不扣费。第二步是 AI 重建而不是逐像素放大，构图和清晰文字基本保持，细节会被重新绘制。
分组 #177「【GPT 生图】Image 2 + 香蕉 2.1 High · 2K/4K（介意勿用）」 · Key 需属于该分组
文生图图生图1K / 2K / 4KAI 重建多参考图URL 返回Base64 返回
价格—
24 小时成功率—
最近 24 小时
可用模型
| 模型 | 说明 | 价格 |
|---|---|---|
gpt-image-2.5-banana-pro | 第二步香蕉 Pro；默认不发送思考档位；按张 $0.065 | — |
gpt-image-2.5-banana2 | 第二步香蕉 2.0，通常更快、更便宜；默认不发送思考档位；按张 $0.05 | — |
gpt-image-2.5-banana2.1 | 第二步香蕉 2.1；默认请求 Thinking High，是否生效取决于所分配的渠道；按张 $0.06 | — |
接口
POST /v1/images/generations | 文生图，JSON |
POST /v1/images/edits | 图生图，参考图最多 15 张：multipart（image 或 image[]）或 JSON images[].image_url |
GET /v1/models | 返回本组三个模型 id |
能力与限制
| 计费方式 | 按张：banana2 $0.05、banana2.1 $0.06、banana-pro $0.065，全分辨率同价；任一阶段失败不扣费 |
| 每次张数 | 只能 1 张，n 只能为 1 或省略 |
| 支持比例 | 1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、21:9，允许约 3% 误差，其他比例返回 400 |
| 档位判定 | 宽x高的最长边 ≤ 1600 为 1K，≤ 3200 为 2K，更大为 4K；单边上限 6000；省略 size 为 1K 1:1 |
| 参考图 | 最多 15 张；前 6 张文件或 Data URL 缩小到最长边 1536 后也提供给重建步骤，https 链接只用于 GPT 原图步骤 |
| 返回格式 | 默认 url（本站链接，保留 1 小时）；b64_json 或 base64 返回 Base64；4K Base64 可达 20–30 MB |
| 实测像素 | 1K 1:1 为 1024×1024；2K 16:9（2048x1152）为 2752×1536；4K 1:1 为 4096×4096；4K 2:3 为 3392×5056；4K 3:2 为 5056×3392 |
| 耗时（2.1） | 1K 约 60 秒，2K 约 60–75 秒，4K 约 90–105 秒；2.0 通常更快 |
| 超时建议 | 不少于 300 秒 |
| generationConfig | 必须是 JSON 对象，不超过 16 KB |
请求参数
| 字段 | 类型 | 说明 | |
|---|---|---|---|
model | string | 必填 | gpt-image-2.5-banana2、gpt-image-2.5-banana2.1 或 gpt-image-2.5-banana-pro；其他模型名返回 400 invalid_model |
prompt | string | 必填 | 画面主体、场景和风格；图生图写编辑要求；想要的文字用引号写明 |
size | string | 可选 | 1K / 2K / 4K（比例 1:1）或宽x高（推断比例和档位）；省略为 1K 1:1 |
n | integer | 可选 | 只能为 1 或省略 |
response_format | string | 可选 | 省略时返回 url；b64_json / base64 返回 Base64；4K 建议用 url |
quality | string | 可选 | 可以传入，但不改变输出档位 |
generationConfig | object | 可选 | 香蕉阶段参数（Gemini 原生格式），只合并到第二步：thinkingConfig.thinkingLevel、temperature、topP、topK、seed、imageConfig.imageSize、imageConfig.aspectRatio；multipart 时传 JSON 字符串 |
image / image[] | file | 可选 | 图生图（multipart）参考图，每张一个字段，最多 15 张 |
images | array | 可选 | 图生图（JSON）参考图，每项 {"image_url": Data URL 或公开 HTTPS 图片直链} |
注意事项
- 构图、人物身份、画风和可辨认的中日英文字基本保留并更清晰，整体可能轻微偏暖。
- 重建步骤会读取原始 prompt 来校正画面文字，请用引号写明确切文字，例如：招牌上写着 "OPEN 24H"。
- 需要还原 Logo、文字、人脸等细节时，参考图用文件上传或 Data URL；https 链接参考图不参与重建。
- 提示词未提及的极小文字或数字（表盘、包装小字等）仍可能与原意不一致；产品外观、包装文字等需要逐项核对。
- 需要逐像素忠实放大时本分组不适用。
- size 决定比例和档位，实际像素以返回图片和响应中的 size 为准。
- data[0].url 保留 1 小时，下载时不要携带 API Key。
- output_format 仅供参考，保存时按文件头判断：89 50 4E 47 为 PNG，FF D8 FF 为 JPEG。
- generationConfig.imageConfig 与 size 同时提供且不一致时返回 400，只保留一处。
- 不支持流式，不提供 Chat Completions、Responses、Messages 入口。
- 超时后先查看使用记录，再决定是否重新提交，避免重复生成。
常见错误
| 返回 | 原因与处理 |
|---|---|
401 / 403 | Key 错误、已禁用或未绑定该分组；检查 Authorization: Bearer 请求头、绑定分组和访问权限。 |
400 invalid_model | 模型名不是本组三个模型之一。 |
400 invalid_image_count | n 不是 1；改为 1 或省略，需要多张时分多次请求。 |
400 stream_not_supported | 去掉 stream。 |
400 invalid_image_size | size 格式错误或单边超过 6000。 |
400 conflicting_aspect_ratio / conflicting_image_size | generationConfig.imageConfig 与 size 的比例或档位不一致；只保留一处。 |
400 invalid_generation_config | generationConfig 不是有效 JSON 对象（含数组）或超过 16 KB。 |
400 unsupported_aspect_ratio | 比例不在支持列表中；改用 10 种支持的比例之一。 |
400 missing_prompt / missing_image | prompt 为空，或调用 /v1/images/edits 时没有参考图。 |
400 invalid_image_request | 原图请求参数有误；按 message 修改。 |
400 image_safety_rejected · 非常抱歉，生成的图片可能违反了我们的内容政策…… | 未通过图片安全检查；调整提示词或参考图。 |
413 image_too_large | 上传的参考图过大；压缩后重试。 |
429 image_channel_busy | 渠道繁忙；稍后重试并降低并发。 |
502 image_generation_failed / banana_rebuild_failed / image_upstream_error | GPT 原图生成、香蕉重建或渠道暂时异常；稍后重试。 |
502 / 503 Upstream service temporarily unavailable · No available compatible accounts | 上游短暂故障；稍后重试，先在使用记录确认没有成功结果。 |
504 image_generation_timeout | 生成超时；先核对使用记录再重试。 |