One API（3.6万星）大模型网关搭建指南2026：一个Key打通OpenAI、Claude、Gemini和DeepSeek

one-api（36,211星）是星标最多的大模型API网关：把OpenAI、Azure、Claude、Gemini、DeepSeek、豆包统一到一个Key后面。本文给出完整自建教程。

💡 你将学到

one-api（36,211星）是星标最多的大模型API网关：把OpenAI、Azure、Claude、Gemini、DeepSeek、豆包统一到一个Key后面。本文给出完整自建教程。

📜 目录

• 直接给结论
• 为什么团队要自建
• 10分钟部署
• 实用建议
• FAQ
• 相关文章

直接给结论

songquanpeng/one-api（36,211星，JavaScript）是一个大模型API管理与分发系统。它把OpenAI、Azure、Anthropic Claude、Google Gemini、DeepSeek、字节豆包、智谱等几十家服务商聚合到一个OpenAI兼容端点后面。团队只需一个Key，由one-api统一转发、计量和限流。

为什么团队要自建

• 统一Base URL：所有模型都是 http://你的服务器:3000/v1
• 按用户配额：给每个成员单独建Token、设置每日消费上限
• 成本追踪：每个请求都记录模型、token数和费用
• 模型容灾：某家服务商挂了自动切换到备用渠道

10分钟部署

1. 启动容器（小团队用SQLite模式即可）：

docker run --name one-api -d --restart always \n  -p 3000:3000 -v /data/one-api:/data \n  ghcr.io/songquanpeng/one-api:latest

1. 打开 http://localhost:3000，默认管理员是 root / 123456（立刻改掉）。
2. 进入渠道 - 添加渠道：选择服务商（如OpenAI），粘贴API Key。
3. 进入令牌 - 创建令牌，这就是你的应用要用的唯一Key。
4. 把任意OpenAI SDK指向 http://localhost:3000/v1，填入新令牌。

实用建议

• 开启模型倍率设置，给不同模型设置独立的价格倍数。
• 用日志页面防滥用，能实时看到每个用户消耗的token。
• 生产环境每天备份 /data 目录（SQLite库或MySQL）。

FAQ

兼容OpenAI SDK吗？ 兼容——它暴露的 /v1/chat/completions 与OpenAI完全一致，LangChain、Open WebUI等工具无需改动即可接入。

能转发本地模型吗？ 能，添加指向Ollama或vLLM的渠道，本地和云端模型共用同一个Key。

支持国内服务商吗？ 支持——DeepSeek、豆包、通义、智谱等都有内置预设。

相关文章

• 2026年WhatsApp AI机器人：用whatsapp-web.js（2.2万星）自建，零API费用
• 统一 LLM API 网关 2026：LiteLLM、one-api、new-api 对比
• Perplexity API 指南 2026：Base URL、请求格式和该调用哪个模型

❓ 常见问题

Is it compatible with the OpenAI SDK?

Yes - it exposes `/v1/chat/completions` exactly like OpenAI, so LangChain, Open WebUI and most tools work unchanged.

Can it route to local models?

Yes, add a channel pointing at Ollama or vLLM and serve local and cloud models through the same key.

Does it support Chinese providers?

Yes - DeepSeek, Doubao, Qwen, Zhipu and others are built-in presets.