知梦AI文档

Appearance

NewAPI 渠道对接 ​

本页面面向需要把知梦服务添加为自己 NewAPI 上游渠道的管理员。普通应用开发者请直接阅读 GPT-Image-2 对接 或 Banana2 / Banana Pro 对接。

最重要的规则 ​

NewAPI 的 OpenAI 渠道会把用户请求路径原样拼到 Base URL 后面。因此后台渠道 Base URL 不能带 /v1。

配置位置正确示例错误示例
应用 / SDK Base URLhttps://api.zmoapi.cn/v1—
NewAPI 渠道 Base URLhttps://api.zmoapi.cnhttps://api.zmoapi.cn/v1

如果 NewAPI 渠道里误填了 /v1，最终可能请求成 /v1/v1/images/generations，表现为 404 或“对接不了”。

接入 GPT-Image-2 ​

在“渠道管理 → 添加渠道”中填写：

字段值
类型OpenAI
Base URLhttps://api.zmoapi.cn
密钥从知梦 API 平台获得的 sk-... Key
模型gpt-image-2
模型映射留空

1K / 2K / 4K 路由说明 ​

知梦网关对外统一使用模型名 gpt-image-2。1K、2K、4K 是 Key 所属分组和上游路由，不是对外模型名。

text
客户端模型名：gpt-image-2
上游模型名：  gpt-image-2
分辨率路由：  由知梦侧分配给该 Key 的分组决定

不要在模型列表中自行填写 gpt-image-2-2k 或 gpt-image-2-4k，除非知梦明确为你的 Key 开放了这些公开别名。

接入 Banana2 / Banana Pro ​

在“渠道管理 → 添加渠道”中填写：

字段值
类型OpenAI
Base URLhttp://180.178.51.134:19073
密钥Banana 专用对接 Key
模型复制下面七个精确模型名
模型映射留空
text
banana-pro-1k
banana-pro-2k
banana-pro-4k
banana2-512
banana2-1k
banana2-2k
banana2-4k

不要填写知梦网关 Key

Banana 渠道使用独立的专用对接 Key。把 api.zmoapi.cn 的普通 sk-... Key 填到此渠道会返回 401。

模型映射怎么填 ​

模型映射方向是：左侧为你的用户调用名，右侧为知梦上游的真实模型名。

如果你希望用户仍然调用上游真实名称，模型映射留空即可，这是最稳的配置。

如果你确实需要自定义别名，例如让用户调用 my-banana-pro，可以填写：

json
{
  "my-banana-pro": "banana-pro-2k"
}

同时必须把左侧别名 my-banana-pro 加入该渠道的“模型”列表。不要把映射方向写反。

GPT-Image-2 的别名示例：

json
{
  "my-gpt-image": "gpt-image-2"
}

渠道测试 ​

  1. 保存渠道。
  2. 在渠道管理中执行“测试”。Banana 包装服务兼容 /v1/chat/completions 探活，因此 NewAPI 的普通渠道测试可以通过。
  3. 再用真实图片接口测试，不要只以渠道测试按钮为最终依据。

GPT-Image-2：

bash
curl https://你的下游NewAPI地址/v1/images/generations \
  -H "Authorization: Bearer 你的下游NewAPI-Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只放在木桌上的白色陶瓷杯",
    "n": 1
  }'

Banana Pro：

bash
curl https://你的下游NewAPI地址/v1/images/generations \
  -H "Authorization: Bearer 你的下游NewAPI-Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "banana-pro-2k",
    "prompt": "一张高级商业产品海报",
    "aspectRatio": "1:1",
    "n": 1
  }'

反向代理与超时 ​

图片生成可能持续数分钟。下游 NewAPI、Nginx、Cloudflare 和客户端任一层提前断开，都会表现为超时。

  • 客户端读取超时建议不少于 600 秒。
  • Nginx 建议设置 proxy_read_timeout 600s 或更高，并关闭响应缓冲。
  • Banana 服务会定期发送空白心跳保持连接，代理层不要把它缓存到任务完成才一次性返回。
  • 使用当前 HTTP Banana 地址时只建议服务端到服务端调用，不要把专用 Key 放到浏览器前端。

常见配置错误 ​

现象原因修正
404渠道 Base URL 带了 /v1去掉渠道地址末尾的 /v1
401GPT Key 与 Banana Key 混用换成对应服务的 Key
model not found模型名未加入渠道或拼写错误使用本文列出的精确名称
no available channel下游 Key 分组没有该模型能力检查渠道分组、令牌分组和能力表
请求转到错误模型模型映射方向写反左边用户模型，右边上游真实模型
渠道测试通过但生图失败只测了 Chat 探活再测试 /v1/images/generations

知梦AI文档中心