快速开始

知梦目前有两套独立图片服务。最常见的对接失败来自“地址、Key、模型名混用”，所以第一步不是写代码，而是先选对服务。

选择服务

需要的能力	应用直连 Base URL	Key 类型	模型
GPT 文本 / GPT-Image-2	https://api.zmoapi.cn/v1	知梦 API 平台 sk-... Key	gpt-5.5、gpt-image-2 等，以模型列表为准
Banana Pro / Banana2	http://180.178.51.134:19073/v1	Banana 专用对接 Key	七个 banana-pro-* / banana2-* 模型

下游 NewAPI 管理员

把服务添加成 NewAPI 渠道时，Base URL 不带 /v1。请直接阅读 NewAPI 渠道对接。

第一步：查看当前 Key 的模型

GPT 网关：

curl https://api.zmoapi.cn/v1/models \
  -H "Authorization: Bearer 你的知梦 API Key"

Banana：

curl http://180.178.51.134:19073/v1/models \
  -H "Authorization: Bearer 你的 Banana 专用对接 Key"

只有模型列表里出现的精确名称才能调用。

第二步：最小生图测试

GPT-Image-2：

curl https://api.zmoapi.cn/v1/images/generations \
  -H "Authorization: Bearer 你的知梦 API Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只放在木桌上的白色陶瓷杯",
    "n": 1
  }'

Banana Pro：

curl http://180.178.51.134:19073/v1/images/generations \
  -H "Authorization: Bearer 你的 Banana 专用对接 Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "banana-pro-2k",
    "prompt": "一只放在木桌上的白色陶瓷杯",
    "aspectRatio": "1:1",
    "n": 1
  }'

第三步：接入应用

• 服务端通过环境变量保存 Key，不要写入网页前端或公开仓库。
• 图片请求可能耗时数分钟，客户端读取超时建议设为 600 秒以上。
• 上传参考图时使用 /v1/images/edits 和 multipart/form-data。
• 成功时读取 data[].url 或 data[].b64_json。
• 生产环境记录请求时间、模型名、HTTP 状态码、错误 message 和请求 ID，但不要记录完整 Key。