https://makismkuous-bot.github.io/tags/sub2api/ Recent content in Sub2api on Fanssen Notes https://makismkuous-bot.github.io/ https://makismkuous-bot.github.io/ Hugo zh-cn Sat, 23 May 2026 00:00:00 +0000 https://makismkuous-bot.github.io/posts/self-host-sub2api/ Sat, 23 May 2026 00:00:00 +0000 https://makismkuous-bot.github.io/posts/self-host-sub2api/ <p><img alt="sub2api 中转架构" loading="lazy" src="https://makismkuous-bot.github.io/images/sub2api-arch.svg"></p> <h2 id="为什么需要-api-中转">为什么需要 API 中转</h2> <p>做 AI 开发时间长了，手里攒的模型越来越多：OpenAI 的 GPT-4o、Claude 的 Sonnet 4、DeepSeek 的 V3 和 R1、还有本地跑的 Llama……每个模型都有自己的 API Key、独立的接口地址、不一样的计费方式。</p> <p>一开始没啥感觉，反正写死一个模型也能用。但当你开始做稍微复杂点的项目——比如一个 Telegram Bot 同时接了好几个模型，或者你在做 RAG 应用需要根据任务类型自动选模型——这时候问题就来了：</p> <ul> <li>代码里到处都是不同的 base_url 和 api_key</li> <li>想换模型，得改代码、重新测试、重新部署</li> <li>某个模型挂了切到另一个，手忙脚乱</li> <li>月底对账一看，每个平台各算各的，根本理不清到底花了多少钱</li> </ul> <p><strong>sub2api 就是来解决这些问题的。</strong> 它本质上是一个轻量级的反向代理层，把你的所有 API 请求统一到一个入口。你的代码只认一个地址、一个 Key，背后路由到哪个模型由 sub2api 说了算。</p> <h2 id="架构概览">架构概览</h2> <pre tabindex="0"><code>┌─────────────────┐ ┌──────────┐ ┌──────────────┐ │ 你的客户端代码 │────▶│ sub2api │────▶│ OpenAI │ │ (Bot/Agent/App) │ │ (中转) │ ├──────────────┤ └─────────────────┘ │ │ │ Claude │ │ │ ├──────────────┤ │ │ │ DeepSeek │ │ │ ├──────────────┤ │ │ │ 其他/本地 │ └──────────┘ └──────────────┘ </code></pre><p>客户端看到的就是一个标准的 OpenAI 兼容 API。你传一个请求过来，sub2api 根据你指定的模型名，自动决定转发到哪个后端，拿到响应后再原样返回给你。中间的所有差异——不同厂商的认证方式、请求格式、响应结构——都由它来抹平。</p>