账号与密钥

API Key 用于鉴权和计费。所有接口请求都需要在请求头里携带密钥。

两种 Key

Key	使用地址	用途
知梦 API 平台 sk-... Key	https://api.zmoapi.cn/v1	GPT 文本、GPT-Image-2
Banana 专用对接 Key	http://180.178.51.134:19073/v1	Banana2、Banana Pro

两种 Key 不能混用。下游 NewAPI 管理员还要注意：渠道 Base URL 不带 /v1，详见 NewAPI 渠道对接。

请求头格式

Authorization: Bearer sk-xxxxxxxx

JSON 请求还需要带上：

Content-Type: application/json

文件上传请求通常使用 multipart/form-data，由 curl -F 或 SDK 自动生成 Content-Type，不要手动写错 boundary。

密钥安全

• 不要把 API Key 写进前端页面、App 包、公开 Git 仓库或截图里。
• 服务端通过环境变量或密钥管理工具读取 API Key。
• 不同项目建议使用不同 Key，方便排查和停用。
• 如果怀疑泄露，应立即停用旧 Key 并更换新 Key。

额度与计费

不同模型的计费方式可能不同。文本模型通常按 token 或渠道规则计费；图片模型通常按模型、尺寸、质量或上游规则计费。实际扣费以平台账户记录为准。

接入前建议先做三类测试：

1. /v1/models 能否正常返回模型列表。
2. 小文本请求能否成功返回。
3. 生图请求能否返回最终图片 URL 或 b64_json。

排查建议

报错	含义	处理方式
401	鉴权失败	检查 API Key 是否正确、是否带 Bearer
403	当前账号无权限	检查模型权限、账号组或额度限制
404	地址或路径错误	下游 NewAPI 渠道地址不要带 /v1
429	请求过快或额度限制	降低并发，检查账户额度
insufficient_quota	余额或额度不足	充值或更换有额度的 Key