一句话：它是一层代理网关，架在「你」和各大模型官方 API 中间，统一收你的请求，转发给上游大模型，再把结果回传给你，行业里常叫 OneAPI / NewAPI 面板就是这类开源实现。
链路：你的程序 / AI 工具 → 中转站（统一 API Key）→ 上游 GPT/Claude/DeepSeek/Kimi 等官方接口 → 返回内容
✅ 它能干什么（正规用途）
- 统一协议、一套 key 调用多模型 大多做成兼容 OpenAI 接口格式，不用改代码，换模型只需要改参数，不用对接各家厂商不同接口。适合你做 AI 工具、RAG 知识库、GEO 内容生成、站内 AI 助手。
- 计费、额度、权限、日志统一管理 给子用户分配额度、统计每个项目 token 消耗、限流、看调用日志，适合团队、SaaS 项目内部管理算力成本。
- 负载分摊、故障自动切换（路由） 上游某个模型超时 / 封号，自动切到备用模型 / 备用 key，提升稳定性（专业叫法：模型路由 Router）。
- 批量采购折扣，摊薄成本 批量拿官方 API 折扣，再拆分卖给下游用户，赚 token 差价（这是它最主要商业模式）。
⚠️ 区分：合规中转 vs 违规黑市中转（重点）
合规场景（国内云厂商官方网关，如腾讯 TokenHub 这类）
拿到模型厂商正规授权，不跨境违规传输数据，只聚合国内已备案大模型，做统一计费和路由。
市面上大量民间个人中转站（高风险）
很多是拿海外 OpenAI、Claude 账号 key 池，翻墙接入，再对国内售卖，用来绕过地区限制、支付门槛。这个是监管重点打击的：
- 数据跨境：你提交的 prompt、代码、网站内容会出境；
- 协议违规：OpenAI 等用户协议禁止二次转售、代跑；
- 安全隐患：你所有发给 AI 的内容全部经过中转站服务器，运营方可以全部留存、查看，源码、业务文档、网站素材有泄露风险；
- 随时跑路、封号：上游 key 被封，你的服务直接断，余额不退央广网。 国家安全部专门发文提示 AI 中转站风险央广网。
🧰 常见技术实现
开源面板：OneAPI、New-API，很多人自己搭服务器部署，自己做自用中转或者对外售卖。 核心能力：密钥池、负载均衡、优先级路由、重试、配额、账单统计。
📌 和你建站、GEO 的关联（对你很关键）
如果你打算做：
- 站内 AI 问答、RAG 知识库、自动生成 GEO 内容、批量生成技术文章； 你有两个方案：
- 直接对接各家官方 API：稳定、合规、数据不外流，但是要维护多个 key、多个接口；
- 自建合规 Token 中转站：用 OneAPI 聚合国内合规大模型（DeepSeek、通义、混元等），一套接口管理，方便批量调用做内容生产、GEO 素材生成；
❌ 不建议用网上不知名第三方海外中转站跑你的站点素材、业务资料。
📋 简单优缺点总结
✅ 优点：接入简单、统一管理、自动路由切换、方便额度管控 ❌ 缺点（第三方中转）：多一层延迟、数据要过第三方、有跑路 / 封号风险、很多跨境中转不合规
一句话红线
自建只聚合国内合规大模型、不上传境外，属于正常技术网关；拿海外模型 key 对国内倒卖、跨境代调用，属于违规。
用途：给你的技术站批量写 GEO 文章、RAG 知识库、站内 AI 助手；只接入国内厂商，不碰 GPT/Claude，合规 环境：Linux 服务器（宝塔也可以），Docker 方式最简单
一、前置准备（必须先做）
- 一台国内服务器，放行 3000 端口；建议绑定域名 + 配置 SSL（https，调用更稳）
- 分别去厂商后台开通 API，拿到 Key：
- DeepSeek：https://platform.deepseek.com
- 通义千问（阿里百炼）：https://dashscope.aliyuncs.com
- 腾讯混元：https://hunyuan.cloud.tencent.com
- 智谱 GLM：https://open.bigmodel.cn
- 火山方舟豆包：https://www.volcengine.com/ark
全部都是国内合规、按量计费，数据不出境
二、Docker 一键部署命令
docker run -d \
--name one-api \
-p 3000:3000 \
-v /opt/oneapi-data:/data \
-e TZ=Asia/Shanghai \
songquanpeng/one-api:latest
- 访问地址：
http://服务器IP:3000 - 默认账号：
root，默认密码：123456✅ 登录第一件事：修改管理员密码！
宝塔用户简化方案：宝塔应用商店搜索 OneAPI，一键安装，自动处理端口、目录，适合不想敲命令
三、添加渠道（核心配置，国内模型参数汇总）
后台 → 渠道 → 新建渠道，类型直接选对应厂商：
表格
| 模型 | 渠道类型 | BaseURL | 备注 |
|---|---|---|---|
| DeepSeek | DeepSeek | https://api.deepseek.com | deepseek-chat / deepseek-flash |
| 通义千问 | DashScope | https://dashscope.aliyuncs.com/compatible-mode/v1 | qwen-turbo、qwen-plus |
| 腾讯混元 | Hunyuan | https://api.hunyuan.cloud.tencent.com/v1 | hunyuan-turbo |
| 智谱 GLM | 智谱 | https://open.bigmodel.cn/api/paas/v4 | glm-4-flash 免费额度很香 |
| 火山豆包 ARK | VolcEngine (豆包) | https://ark.cn-beijing.volces.com/api/v3 | 需要 AppID 填额外请求头 |
操作要点：
- 名称随便写（DeepSeek - 主），模型列表填厂商原生 model id，不能写错
- API Key 填入厂商给到的密钥；支持多 key 换行，自动轮询
- 优先级：给便宜稳定的模型高优先级，贵的推理模型做兜底
- 填完点测试，连通成功再保存
四、令牌（key）创建，给你的程序调用
后台 → 令牌 → 添加令牌
- 名称：
51root-GEO生产 - 额度：设置每日限额（防止跑超费用）
- 模型：勾选允许调用哪些上游模型 生成后拿到中转 Key。
统一调用地址（OpenAI 兼容格式）：
https://你的域名/v1/chat/completions下游代码、RAG、AI 写作工具，直接填这个地址 + 这个令牌，不用改代码，切换模型只在 OneAPI 后台调度。
五、路由策略（对你批量写 GEO 文章非常实用）
后台渠道支持：
- 优先级路由：优先便宜 GLM-4-Flash，失败自动切 DeepSeek
- 权重分流：多个渠道分摊 token 消耗
- 自动故障摘除：上游渠道连续报错，自动下线，避免批量失败
适合场景：批量生成 Linux 教程、FAQ、GEO 结构化内容，防止单一厂商限流打断任务
六、配套安全 & 合规设置（重中之重）
✅ 必开：
- 开启访问密码，不要裸奔公网直接暴露管理后台
- 设置令牌额度上限，防止密钥泄露巨额扣费
- 日志开启，记录所有 prompt 和消耗（方便排查 GEO 素材生成质量） ❌ 红线，严格遵守
- 不要添加任何境外 OpenAI/Claude 渠道，避免跨境数据违规
- 不要对外售卖 / 分发令牌，仅限自用（你的 51root 站点内容生产）；对外分发售卖属于违规
- 所有 prompt、技术素材都在国内链路流转，数据不出境