对接总览

知梦的 GPT 生图与 Banana2 / Banana Pro 是两套独立服务。接入前必须先确认调用哪一套，地址、Key 和模型名不能交叉使用。

先看这张表

能力	直连 Base URL（SDK / curl）	鉴权 Key	公开模型名
GPT-Image-2	https://api.zmoapi.cn/v1	知梦 API 平台生成的 sk-... Key	gpt-image-2
GPT 文本	https://api.zmoapi.cn/v1	知梦 API 平台生成的 sk-... Key	以 /v1/models 返回为准
Banana Pro	http://180.178.51.134:19073/v1	Banana 专用对接 Key	banana-pro-1k、banana-pro-2k、banana-pro-4k
Banana2	http://180.178.51.134:19073/v1	Banana 专用对接 Key	banana2-512、banana2-1k、banana2-2k、banana2-4k

两类 Key 不能混用

知梦 API 平台的 sk-... Key 目前只会在 api.zmoapi.cn 网关内路由，不能拿去调用 Banana 专用地址。Banana 专用 Key 也不能拿去调用知梦 API 网关。

两种接入方式

方式一：应用直接调用

应用、脚本或 SDK 直接请求服务时，Base URL 包含 /v1：

GPT:    https://api.zmoapi.cn/v1
Banana: http://180.178.51.134:19073/v1

方式二：添加到自己的 NewAPI

在 NewAPI 后台添加“OpenAI”渠道时，Base URL 不要包含 /v1，因为 NewAPI 会把原始请求路径 /v1/... 自动拼到渠道地址后面：

GPT:    https://api.zmoapi.cn
Banana: http://180.178.51.134:19073

完整字段见 NewAPI 渠道对接。

图片接口

场景	接口	请求格式
文生图	POST /v1/images/generations	application/json
上传参考图 / 改图	POST /v1/images/edits	multipart/form-data
Banana 使用公网参考图	POST /v1/images/generations	JSON 中传 image_url 或 imageUrls

只有返回 data[].url 或 data[].b64_json 才算生成完成。Banana 服务会等待上游任务完成，不会把上游任务 ID 当成成功结果返回。

推荐排查顺序

1. 用当前 Key 请求对应服务的 GET /v1/models。
2. 确认响应里确实包含准备调用的模型名。
3. 先用本文档的最小 curl 示例测试。
4. curl 成功后，再排查 SDK、工作流平台或下游 NewAPI 的配置。
5. 生图请求的客户端超时建议设为 10 分钟以上。