你手里不是没模型只是上游太散。这篇教程帮你把零散的订阅地址整理成一条标准 API 管线一次接入全局调度。为什么需要统一接入手上有好几个模型的订阅地址比如一个 DeepSeek 的第三方代理、一个 GLM 的直连、一个自部署的 Qwen最常见的问题不是能不能调通而是客户端配置分散IDE 里一套自动化脚本里另一套换上游又要挨个改。a-i³ 上线了自定义上游功能支持你把第三方 API 地址和 Key 接入平台绑定到指定模型上。配置完成后请求由平台自动转发到你的第三方渠道客户端全程无感——你只需要维护一个入口即可。之后所有客户端只认一套信息项目值Base URLhttps://api.a-iii.com/v1鉴权你的 a-i³ 平台 API Keymodel 参数你在平台里配置的前端模型名请求走了哪个上游交给平台去分发。你只需要准备 4 样东西Base URL——上游的公网 API 地址API Key——该上游的密钥上游模型名——该上游真实可调用的模型名称额外 Headers可选——对方要求特殊鉴权时填写关键是第 3 项。在平台里切换自定义上游时填的是该型号在上游实际使用的模型名不是你自己起的备注名。在 a-iii.com 里如何接入Step 1登录 Portal进入模型接入先获取你的平台接入信息——Base URL 和 API Key。这一步不要修改客户端配置先在平台里把上游接好。Step 2进入按型号精细配置如果你只想让某几个型号走自己的第三方进入精细配置找到对应型号点击**“切换为自定义第三方”**。这是最实用的设计不需要整站切换只改你关心的几个模型。点击接入自定义第三方Step 3创建一个自定义上游 Provider如果还没接过第三方在弹窗上点击**“接入新的第三方”**。需要填写的字段字段说明显示名称方便你自己识别Base URL第三方标准 API 地址如https://xxx.com/v1API Key第三方接口的密钥额外 Headers (JSON可选)对方要求额外请求头时填写Step 4选择 Provider 填写上游模型名保存 Provider 后选择刚创建的接入商填写上游模型名——例如glm-5.2、deepseek-v4如果填错平台可以接通第三方但实际转发时会请求错误的模型。Step 5保存等待生效切换后大约2 分钟内生效。发一笔新请求测试然后去请求详单确认链路。接入完成后客户端如何发请求客户端配置反而更简单了——不需要修改 URL也不需要传入第三方 Key。无论是chat/completions、messages还是responses都统一使用平台入口curlhttps://api.a-iii.com/v1/chat/completions\-HAuthorization: Bearer 你的a-i³平台Key\-HContent-Type: application/json\-d{ model: 你切到自定义上游的前端模型名, messages: [{role: user, content: ping}] }这里有两个名字需要区分客户端发送的是前端模型名平台转发给第三方时使用的是你在 Portal 中配置的上游模型名客户端无需感知你背后换了哪家上游。如何确认请求走到了第三方发送一笔新请求然后查看请求详单。如果链路中显示自定义第三方 · provider_key同时列出了对应的上游模型名说明该请求已走到你配置的第三方上游而非平台默认路由。这种接入方式的实际价值对个人开发者或小团队来说a-iii.com 可以同时提供三类能力它们不是替代关系而是互补① 平台路由模型——平台提供 lite / pro / ultra 三档模型组合覆盖从轻量对话到深度推理的多种场景。无需自己维护上游开箱即用且享受平台最优算力调度兼具性能和性价比。② 官方直连——通过平台走官方 API比个人订阅更稳定且享受平台的负载均衡和容灾能力。适合对可用性要求高的生产场景。③ 自定义上游——你手里已有的第三方渠道挂到平台统一管理。适合你有特殊渠道更便宜、更新、或某些特定模型独占的场景。这三类能力的共同收益是跨端配置统一场景接入前接入后IDECursor / Continue 等每换一个 IDE 要配一遍上游全 IDE 共用平台 Key自动化脚本 / CI 流程每个脚本里硬编码第三方地址脚本只认平台入口换上游不改脚本团队协作每人自己维护一套上游配置团队共用一套平台配置模型切换改一个客户端就要改一遍配置平台侧统一切换客户端零改动你可以理解为前两类是平台为你维护的官方能力第三类是你自己带来的个人资产。无论哪种客户端始终只认一套平台入口不需要知道背后有几家上游、Key 放在哪、地址有没有变。常见问题把订阅链接当成标准 API不是所有订阅链接都能直接接入。a-i³ 接入的是标准 API不是任意订阅格式。这是最容易踩的坑。可以直接接入的一个公网可访问的 API 地址有可用的 API Key接口支持 OpenAI chat、Anthropic messages 等标准协议不能直接接入的仅用于面板分发的原始订阅链接仅供本地客户端使用的节点订阅只能在内网或本机访问的地址localhost、IP 直连的地址a-i³ 自定义上游做的是统一接入和统一调度不是把任意订阅格式现场解析成 API。你需要先把订阅来源变成一个公网可达的标准 API 接口chat、messages 等主流协议均可再把这个接口接入平台。上游地址只能本地访问如果地址只能在你电脑、内网或容器里访问平台会拒绝接入。模型名填成自己编的名字真正生效的是上游的真实模型名不是你自己起的备注名。接入后又去客户端修改第三方 Key接入 a-i³ 后客户端只认 a-i³ 的 Base URL 和平台 Key。第三方 Key 只保存在平台侧不要在客户端里改回去。一句话总结更省心的方式不是让客户端追着各种订阅地址跑而是先把这些来源收拢成一个标准 API再挂到 a-iii.com 后面。前面统一接入后面按需切换路由、直连或自定义上游。你得到的不是又多一个上游而是以后只维护一个入口。
 获取与实战)
