团队里有人用 GPT-4o，有人用 Claude，还有人用 DeepSeek——每个人手里一把 API Key，管理混乱、用量无法统计、成本也难以分摊。One API 的做法是：把所有 AI 模型接口收归到一个统一的 OpenAI 兼容网关，对内分发、统一计费。
什么是 One API？
One API 是一款开源的 AI 接口聚合网关，通过标准的 OpenAI API 格式统一代理 30+ 家大模型提供商的接口，任何支持 OpenAI SDK 的工具无需修改代码即可切换后端。
协议：MIT License
支持的模型提供商
One API 支持 30+ 家主流提供商，包括：
国际：OpenAI、Azure OpenAI、Anthropic Claude、Google Gemini、Mistral、Groq、Cohere、xAI、together.ai、novita.ai
国内：百度文心、阿里千问、字节豆包、讯飞星火、智谱 ChatGLM、月之暗面 Moonshot、百川、MiniMax、DeepSeek、SiliconFlow、阶跃星辰
本地：Ollama（通过 OpenAI 兼容接口接入）
核心功能
统一 API 格式：所有提供商的接口统一转换为 OpenAI 格式，调用方无感知切换。
Token 管理：为不同用户或应用生成独立 Token，可设置过期时间、配额上限、IP 白名单、模型访问限制。
多渠道负载均衡：同一模型可配置多个上游渠道，支持加权轮询和自动故障切换。
用量与额度管理：统计每个 Token 的请求量和费用，支持充值码系统和邀请奖励，可按用户分配额度。
分组定价：不同用户组可设置不同的计费倍率，适合对外分发的场景。
SSE 流式响应：完整支持流式输出，实时返回模型生成内容。
用户系统：支持邮件、GitHub OAuth、飞书 OAuth 等多种登录方式。
架构示意
One API 是中间层，上游对接各家提供商，下游面向内部用户或应用：
[调用方：Open WebUI / LobeChat / 自研应用]
↓（OpenAI 格式）
[One API 网关] ← Token 鉴权 / 配额限制 / 计费统计
↓ ↓ ↓ ↓
[OpenAI] [Claude] [DeepSeek] [其他 30+ 提供商]与 New API 的区别
New API 是基于 One API 的社区增强版，数据库完全兼容，可直接迁移。主要区别：
| 对比项 | One API | New API |
|---|---|---|
| API 格式转换 | 仅 OpenAI 格式 | OpenAI ↔ Claude ↔ Gemini 双向互转 |
| 推理模型 | 基础支持 | 原生支持，可配置推理力度 low / medium / high |
| 数据看板 | 基础统计 | 可视化统计控制台 |
| 缓存计费 | ✗ | ✓ 精确到 Token 级别 |
| 认证方式 | 邮件、GitHub、飞书 | 增加 Discord、LinuxDO、Telegram、OIDC |
| 界面语言 | 中英文 | 中文、英文、法文、日文 |
可以解决什么问题
团队 API 统一分发：公司购买各家 API Key 后，通过 One API 统一下发给团队成员，避免直接暴露原始 Key。
成本统计与分摊：按 Token 统计每个用户的用量和费用，方便部门间成本核算。
多提供商容灾：同一模型配置多个渠道，主渠道故障时自动切换备用，提升可用性。
对外分发服务：以 OpenAI 兼容接口对外提供服务，内部路由到实际提供商，用户不需要关心后端用的哪家。
使用 Docker Compose 部署
创建 docker-compose.yml 并写入以下内容：
services:
one-api:
image: justsong/one-api:latest
container_name: one-api
ports:
- "3000:3000"
volumes:
- ./data:/data
environment:
- TZ=Asia/Shanghai
restart: unless-stopped执行 docker compose up -d 启动后，访问 http://<server-ip>:3000，使用默认账号 root 登录。
注意：默认 root 密码为
123456，首次登录后请立即修改。
在 1Panel 上的一键部署
1Panel 应用商店已上架 One API。进入应用商店搜索 "One API"，点击安装，配置端口和数据目录后提交，不用手写 Compose 文件。
👇 1Panel 官方地址
安装 1Panel
以 root 用户身份运行以下一键安装脚本，自动完成 1Panel 的下载和安装：
bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"📖 详细安装说明：请参考 1Panel 官方安装文档
安装 One API
登录 1Panel，进入应用商店，搜索 One API，点击安装，配置访问端口（默认 3000）和数据挂载路径，勾选端口外部访问后提交即可。
安装完成后在已安装页面点击跳转，使用
root / 123456登录，立即修改默认密码，然后在渠道管理中添加上游 API Key。
