一、先准备四个字段
| 字段 | 填写什么 | 核对点 |
|---|---|---|
| Base URL | https://api.lashimao.xyz/v1 | 不要重复拼接 /v1 或 /chat/completions |
| API Key | 你在上游平台注册后自己创建的 Key | 不把完整 Key 发给任何人 |
| Model | 控制台当前公开模型名 | 大小写、连字符和版本号完全一致 |
| 测试请求 | 你的常用模型和一条短 prompt | 请求、日志、扣费都能对应 |
不要把“注册成功”当成“上游可用”。
最小验收是：请求返回成功、new-api 能看到对应日志、上游控制台能看懂余额或扣费。三项缺一项，都先停在测试状态。
二、在 new-api 中创建渠道
不同版本的 new-api 字段名称可能略有不同，但核心关系相同：上游地址负责路由，Key 负责认证，模型映射负责把下游请求名转成上游实际模型名。
- 打开 new-api 的渠道或供应商配置页面，选择 OpenAI 兼容类型。
- 把上游 Base URL 填到“代理/地址”字段，保持
/v1层级。 - 把自己的 Key 填入密钥字段，保存后只在站内使用；不要把它写进公开仓库。
- 把下游展示模型映射到控制台实时可用的模型名，先只开放一个常用模型。
openai-compatible.json
// placeholder only: replace with your own key in your own account
{
"base_url": "https://api.lashimao.xyz/v1",
"api_key": "sk-your-own-key",
"model": "gpt-5.6-luna"
}三、用一条真实请求验收
不要一开始打开所有模型或把主渠道切过来。选择一个真实会用到的模型，发送一条低成本请求，再分别确认：
- 客户端或 new-api 返回正常响应，并且模型名符合预期。
- new-api 的调用日志能找到对应请求时间、模型和状态。
- 上游控制台的余额、用量或扣费记录能找到同一笔调用。
- 错误时只提供脱敏的时间、模型和错误码，不提供密码或完整 Key。
如果出现 401，优先检查 Key 和地址；出现 404，检查路径和模型映射；出现 429 或 5xx，记录时间、模型与请求 ID，再看服务状态页。不要用不断重试掩盖问题。
四、什么时候可以放量
只有当请求、日志、扣费三项都能重复核对，并且你的实际业务场景愿意保留备用路由，才考虑逐步增加模型或用量。先把它当备用上游，不需要一次性迁移主渠道。