生图说明

能力选择

场景	推荐模型	关键说明
GPT 通用文生图	`gpt-image-2`	使用知梦 API 网关 Key
GPT 参考图改图	`gpt-image-2`	使用 `/v1/images/edits` 上传文件
Banana 高分辨率文生图	`banana-pro-1k/2k/4k`	分辨率由模型后缀决定
Banana2 文生图 / 图生图	`banana2-512/1k/2k/4k`	使用 Banana 专用 Key

地址与 Key 必须配套

text

GPT-Image-2
地址：https://api.zmoapi.cn/v1
Key：知梦 API 平台 Key

Banana2 / Banana Pro
地址：http://180.178.51.134:19073/v1
Key：Banana 专用对接 Key

这两套 Key 不能交叉使用。

文生图与图生图

文生图通常使用：

http

POST /v1/images/generations
Content-Type: application/json

上传参考图使用：

http

POST /v1/images/edits
Content-Type: multipart/form-data

Banana 还支持在 /v1/images/generations 的 JSON 中传 image_url 或 imageUrls，服务会自动切换为图生图。

GPT 分辨率路由

GPT 对外只使用 gpt-image-2。1K / 2K / 4K 是 Key 所属分组和渠道路由，不是请求里的公开模型名。

Banana 则相反：分辨率写在模型名后缀中，例如 banana-pro-2k。

提示词建议

先写清主体：人物、产品、场景或画面元素。
再补充风格：真实摄影、商业海报、插画、电影感、极简设计等。
对改图任务，明确哪些内容保持不变，哪些内容需要变化。
多参考图时说明每张图的用途，例如“图 1 作为人物，图 2 作为产品”。

常见失败原因

现象	常见原因	处理方式
`401`	用错了服务对应的 Key	GPT Key 与 Banana Key 分开使用
模型不存在	模型拼写错误或 Key 未开通	先调用对应地址的 `/v1/models`
参考图没有生效	接口或字段错误	上传文件改用 `/v1/images/edits`
图片 URL 读取失败	URL 需登录、过期或防盗链	换成公网直链或上传文件
请求超时	图片生成耗时较长	客户端与代理超时设为 600 秒以上