企业官网建设流程全解析

你手里不是没模型，只是上游太散。这篇教程帮你把零散的订阅地址整理成一条标准 API 管线，一次接入，全局调度。

为什么需要"统一接入"

手上有好几个模型的订阅地址

• 比如一个 DeepSeek 的第三方代理、一个 GLM 的直连、一个自部署的 Qwen
• 最常见的问题不是"能不能调通"，而是客户端配置分散：IDE 里一套，自动化脚本里另一套，换上游又要挨个改。

a-i³ 上线了自定义上游功能，支持你把第三方 API 地址和 Key 接入平台，绑定到指定模型上。
配置完成后，请求由平台自动转发到你的第三方渠道，客户端全程无感——你只需要维护一个入口即可。

之后所有客户端只认一套信息：

你只需要准备 4 样东西

1. Base URL——上游的公网 API 地址
2. API Key——该上游的密钥
3. 上游模型名——该上游真实可调用的模型名称
4. 额外 Headers（可选）——对方要求特殊鉴权时填写

关键是第 3 项。在平台里切换自定义上游时，填的是该型号在上游实际使用的模型名，不是你自己起的备注名。

在 a-iii.com 里如何接入

Step 1：登录 Portal，进入"模型接入"

先获取你的平台接入信息——Base URL 和 API Key。这一步不要修改客户端配置，先在平台里把上游接好。

Step 2：进入"按型号精细配置"

如果你只想让某几个型号走自己的第三方，进入精细配置，找到对应型号，点击**“切换为自定义第三方”**。
这是最实用的设计：不需要整站切换，只改你关心的几个模型。

点击接入自定义第三方

Step 3：创建一个自定义上游 Provider

如果还没接过第三方，在弹窗上点击**“接入新的第三方”**。
需要填写的字段：

Step 4：选择 Provider + 填写上游模型名

保存 Provider 后：

1. 选择刚创建的接入商
2. 填写上游模型名——例如glm-5.2、deepseek-v4
   如果填错，平台可以接通第三方，但实际转发时会请求错误的模型。

Step 5：保存，等待生效

切换后大约2 分钟内生效。发一笔新请求测试，然后去请求详单确认链路。

接入完成后，客户端如何发请求

客户端配置反而更简单了——不需要修改 URL，也不需要传入第三方 Key。无论是chat/completions、messages还是responses，都统一使用平台入口：

curlhttps://api.a-iii.com/v1/chat/completions\-H"Authorization: Bearer <你的a-i³平台Key>"\-H"Content-Type: application/json"\-d'{ "model": "你切到自定义上游的前端模型名", "messages": [{"role": "user", "content": "ping"}] }'

这里有两个名字需要区分：

• 客户端发送的是前端模型名
• 平台转发给第三方时，使用的是你在 Portal 中配置的上游模型名
  客户端无需感知你背后换了哪家上游。

如何确认请求走到了第三方

发送一笔新请求，然后查看请求详单。如果链路中显示：

• 自定义第三方 · provider_key
• 同时列出了对应的上游模型名
  说明该请求已走到你配置的第三方上游，而非平台默认路由。

这种接入方式的实际价值

对个人开发者或小团队来说，a-iii.com 可以同时提供三类能力，它们不是替代关系，而是互补：
① 平台路由模型——平台提供 lite / pro / ultra 三档模型组合，覆盖从轻量对话到深度推理的多种场景。无需自己维护上游，开箱即用，且享受平台最优算力调度，兼具性能和性价比。
② 官方直连——通过平台走官方 API，比个人订阅更稳定，且享受平台的负载均衡和容灾能力。适合对可用性要求高的生产场景。
③ 自定义上游——你手里已有的第三方渠道，挂到平台统一管理。适合你有特殊渠道（更便宜、更新、或某些特定模型独占）的场景。
这三类能力的共同收益是跨端配置统一：

常见问题

把"订阅链接"当成"标准 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 后面。前面统一接入，后面按需切换路由、直连或自定义上游。
你得到的不是"又多一个上游"，而是"以后只维护一个入口"。