One API：统一管理 OpenAI 等 API 网关

为什么需要 One API？

随着 ChatGPT 等大模型服务的普及，开发者和团队往往要同时对接 OpenAI、Azure OpenAI、Anthropic Claude 等多个平台。每个平台都有独立的 API Key、计费规则和速率限制，管理起来非常繁琐。更麻烦的是，团队成员共享密钥时难以控制每个人的用量和权限，一旦泄露还会造成资损。One API 正是为了解决这些痛点而生的开源项目，它就像一个统一的网关，将所有上游 API 聚合到一个地址下，并提供密钥管理、额度分配和调用监控能力。

One API 的核心功能

多模型接入，一个入口对外

One API 支持 OpenAI 官方、Azure、Anthropic、Google Gemini 等主流模型提供商，也兼容各类开源模型（如 Ollama）。你只需要在后台添加渠道并填写对应的 API Key，之后所有请求都发往 One API 的地址，它会自动路由到实际的上游服务。这意味着前端应用只需要配置一次 Base URL，切换或增加模型时无需改动业务代码。

细粒度的密钥与额度管理

在 One API 中，管理员可以创建多个令牌（Token），并为每个令牌设置额度上限、过期时间以及允许使用的模型范围。团队成员各自使用独立的密钥，调用记录清晰可见，超额后自动失效。这不仅避免了共享密钥带来的安全风险，也方便按项目或按人进行成本核算。

可视化的监控与日志

One API 提供简洁的仪表盘，展示今日调用次数、Token 消耗量、成功率等关键指标。每次请求的日志会被完整保留，包括模型、耗时、输入输出 token 数、状态码等，方便排查问题和分析使用情况。你还可以通过 webhook 对接自己的告警系统，实时掌握服务健康度。

安装与使用步骤

One API 的部署非常简单，推荐使用 Docker 方式。首先确保你的服务器已安装 Docker 和 Docker Compose，然后执行以下命令：

docker run --name one-api -d --restart always -p 3000:3000 -v /data/one-api:/data justsong/one-api

启动后，浏览器访问 http://你的服务器IP:3000，首次登录使用默认账号 root 和密码 123456（请立即修改）。接下来依次完成：

• 在「渠道」页面添加你的第一个 API 提供商，比如 OpenAI，填写密钥并保存。
• 在「令牌」页面创建新的令牌，设置额度限额，复制生成的密钥。
• 将你原本使用的 Base URL 替换为 http://你的服务器IP:3000/v1，API Key 换成刚生成的令牌。

这样，你的应用就成功切换到 One API 了。

注意事项

• 建议使用 HTTPS 反向代理（如 Nginx）访问 One API，避免密钥请求被明文窃听。
• 定期在「日志」页面检查异常调用，发现可疑请求立即禁用对应令牌。
• 升级 One API 前先备份 /data 目录下的数据库文件，以防数据丢失。
• 如果上游 API 有速率限制，可以在渠道设置中配置并发参数，避免触发限流。

One API 由社区活跃维护，目前支持多用户、多渠道的负载均衡，是搭建 AI 服务基础设施的得力工具。无论你是个人开发者还是团队管理者，都能通过它大幅简化接口管理流程。