知梦AI文档

Appearance

常见问题 ​

应用直连和 NewAPI 渠道的 Base URL 为什么不同？ ​

应用或 SDK 直连时地址包含 /v1：

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

添加到下游 NewAPI 的“OpenAI”渠道时不带 /v1：

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

NewAPI 会自动拼接原请求的 /v1/... 路径。渠道里也填写 /v1 可能得到重复路径 /v1/v1/...。

为什么用知梦 API Key 调 Banana 返回 401？ ​

GPT 网关与 Banana 是两套独立服务，Key 不通用。Banana 必须使用单独提供的 Banana 专用对接 Key。

为什么调用 Banana 提示模型不存在？ ​

只能使用以下精确模型名：

text
banana-pro-1k
banana-pro-2k
banana-pro-4k
banana2-512
banana2-1k
banana2-2k
banana2-4k

先用同一个地址和 Key 请求 /v1/models，确认模型存在。

GPT-Image-2 的 1K、2K、4K 模型名怎么写？ ​

都写：

text
gpt-image-2

1K、2K、4K 由知梦为 Key 分配的分组和渠道路由决定，不是外部请求模型名。不要自行使用 gpt-image-2-2k 或 gpt-image-2-4k。

NewAPI 模型映射方向是什么？ ​

左边是你的用户调用名，右边是知梦上游真实模型名：

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

如果不需要别名，模型映射留空最稳。

为什么渠道测试通过，实际生图却失败？ ​

普通渠道测试通常只验证 /v1/chat/completions 探活。它不能证明图片接口、模型权限、文件上传和长连接都正常。保存渠道后还必须实际请求 /v1/images/generations，图生图还要测试 /v1/images/edits。

Authorization 怎么写？ ​

http
Authorization: Bearer 你的 Key

Bearer 后面有一个空格。还要确保 Key 属于当前调用的服务。

为什么图生图参考图没生效？ ​

上传本地文件时使用 /v1/images/edits 与 multipart/form-data：

bash
-F "image=@input.png"

多图推荐：

bash
-F "image[]=@one.png" \
-F "image[]=@two.png"

不要把本地文件路径直接写入 JSON，远端服务器无法读取你的电脑文件。

为什么图片 URL 读取失败？ ​

图片 URL 必须公网可访问、无需登录、未过期且无防盗链限制。短期签名链接过期后也会失败。

为什么请求很久才返回？ ​

图片生成是长任务。客户端、下游 NewAPI 和反向代理的读取超时都建议设为 600 秒以上。Banana 响应中的空白行是保活心跳，不是最终结果。

返回 url 和 b64_json 有什么区别？ ​

url 是图片链接；b64_json 是 Base64 图片内容，需要调用方解码后保存。

生产环境记录哪些信息？ ​

记录请求时间、服务地址、模型名、HTTP 状态码、错误 message、错误 code 和请求 ID。不要记录完整 Key、用户原图或敏感提示词。

知梦AI文档中心