词元广场TOKPUB.COM - 欢迎您，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
NewAPI 中转站下游上游接入对接教程
教程说明
本文档为 NewAPI 开源中转站 下游站点对接上游总站 官方正式接入教程，适用于所有基于 NewAPI 搭建的二级中转站点。下游无需搭建模型、无需编写代码，仅通过后台配置即可完成上游接口对接、流量转发与模型调用，同时兼容 OpenAI、Claude 双协议接口接入。
角色定义
一、接入前置条件
下游站点对接前必须满足以下全部条件，否则会接入失败：
1.
2.
3.
4.
二、完整对接流程（上游授权 + 下游配置）
完整对接分为两大环节：上游总站完成下游授权配置，下游分站完成接口对接配置，缺一不可。同时支持 OpenAI、Claude 两种协议独立对接，互不冲突。
2.1 上游总站配置步骤（上游专属操作）
本步骤由上游站长操作，下游无需配置，仅作知悉，未完成则下游无法调用接口。
5.
6.
7.
8.
9.
2.2 接口协议区分规则（核心必看）
两种模型协议对应独立渠道类型：
2.3 下游分站对接配置步骤（双协议适配）
步骤1：登录下游管理后台
使用下游站点管理员账号登录 NewAPI 后台，进入核心配置页面。
步骤2：新建对应协议上游渠道
方案一：对接 OpenAI 协议模型（主流通用）
1.
2.
3.
4.
5.
6.
方案二：对接 Claude 原生协议模型
7.
8.
9.
10.
11.
12.
步骤3：同步模型与配置路由
13.
14.
15.
步骤4：自定义计费倍率（可选）
可根据自身运营需求，单独为 OpenAI、Claude 通道设置独立计费倍率与用户扣费比例，实现差异化定价盈利。
步骤5：接口连通性自测验收
在下游后台使用在线测试功能，分别调用两类模型，满足以下条件即为接入成功：
三、核心对接关键要点
1.
2.
3.
4.
5.
四、运营与对接注意事项
6.
严禁利用上游资源进行刷量、高频恶意请求、违法违规内容生成等操作，违规将直接封禁权限、清空剩余额度，不予恢复。
7.
出现超时、请求失败优先自查本地服务器网络、防火墙出站规则；禁止频繁重复重连请求，避免触发上游风控限流。
8.
上游实时统计下游流量消耗与额度使用数据，每日自动对账。下游可通过自身后台核对调用记录，流量异常可联系上游运维核查。
9.
下游需妥善保管专属密钥，严禁公开泄露。密钥泄露需第一时间联系上游更换，防止流量被盗刷。
10.
过低版本 NewAPI 存在兼容漏洞，易出现模型同步失败、接口报错，建议全程使用最新稳定版。
五、常见问题排查方案
六、对接完成标准
下游站点可正常同步上游全部模型、终端用户可稳定对话调用、上下游日志记录正常、无报错无限流，即代表对接完成，可正式对外运营使用。