One-API 部署教程：用 Sealos 统一管理你的所有大模型密钥

王正月 發表於 2025-8-13 17:31:00

One-API 部署教程：用 Sealos 统一管理你的所有大模型密钥

身处AI时代，作为开发者的你，是不是也遇到了这样的“甜蜜烦恼”：
<ul>
<li>
今天想用一下 OpenAI 的 GPT-4o；
</li>
<li>
明天想试试 Anthropic 的 Claude 3 Sonnet；
</li>
<li>
后天又要调用国内的文心一言或通义千问...
</li>
</ul>
结果就是，你的代码和配置里散落着十几个甚至几十个不同的 API 密钥和 Base URL。管理起来既混乱又麻烦，分享给团队成员时还担心密钥泄露。
有没有一个优雅的办法，能把所有这些大模型API统一管理起来呢？
答案是肯定的。今天，我们就来介绍这样一位开源界的“大管家”—— One-API。
<img src="https://fael3z0zfze.feishu.cn/space/api/box/stream/download/asynccode/?code=Y2RhMzBkMzg2ZTQ0MjgyYWI1ZmYyNTExZDdmZjhmY2JfazR5YVVXblJSelVSNzFvU2tHTGUwa25uVzdRS0JEN0RfVG9rZW46RVlHUWJ4YzN3b2UxN3h4cG8zcGNPaE5BbnFoXzE3NTUwNzczODc6MTc1NTA4MDk4N19WNA">
One-API 是一个开源的API管理与分发系统。
它可以将市面上几乎所有主流大模型（如 OpenAI, Azure, Claude, 文心一言, Gemini 等）的 API 统一成一个标准接口。
你只需要记住一个地址、一个密钥，就能调用所有模型。
它的核心优势包括：
<ul>
<li>
统一API格式：所有模型的调用都变成了标准的 OpenAI 格式。
</li>
<li>
负载均衡：可以添加多个密钥，系统会自动轮询，避免单个密钥超额。
</li>
<li>
渠道管理：轻松添加、禁用、管理不同大模型的API渠道。
</li>
<li>
用量统计：清晰地看到每个令牌的调用次数和消耗额度。
</li>
</ul>
然而，自己部署 One-API 同样需要服务器、Docker、反向代理等一系列繁琐操作。
但别担心，有了 Sealos 应用商店，这一切都将变得无比简单。
<h3 id="第一步在-sealos-应用商店中找到-one-api">第一步：在 Sealos 应用商店中找到 One-API</h3>
和上次一样，登录你的 Sealos 账号，进入“应用商店”。在搜索框中输入“One-API”，你就能立刻找到它。
<img src="https://fael3z0zfze.feishu.cn/space/api/box/stream/download/asynccode/?code=MWJhM2JhZTUwY2E3MGRjZjE3OGUyZGVlYWI5OTM0OGRfVFBKYndYUjZkd0tVN3NNOHBLdzcwSk1GdHVvWDlocDlfVG9rZW46VkhNZ2JYazM2bzZGTHR4Z0Y3WmNzbGFNbjZkXzE3NTUwNzczODc6MTc1NTA4MDk4N19WNA">
<img src="https://fael3z0zfze.feishu.cn/space/api/box/stream/download/asynccode/?code=NjRkNzJhNDljYWNlYWNkN2JjNDY1MWEyNTk2NjEyNTRfYUJjTGtlNXdwQjJrNXJ4VWN2NnpXdkJtdnpSSEhoUWNfVG9rZW46WjFySGJyS05Eb3hJa0x4UUtBTWNaZE54bjNiXzE3NTUwNzczODc6MTc1NTA4MDk4N19WNA">
<h3 id="第二步一键部署静待花开">第二步：一键部署，静待花开</h3>
点击 One-API 的卡片，进入详情页后，直接点击右上角的“部署应用”按钮。
你什么都不用做，只需静静等待1-2分钟。Sealos 会在云端为你处理好所有事情。
<img src="https://fael3z0zfze.feishu.cn/space/api/box/stream/download/asynccode/?code=YzhlMTVkODIxZjE2M2ExOTg2ODljOTJiNDU5ZTc5YjBfeUh4Vk04SEJHMmZvWTVxcXhtYzRCQVlQcEFobzZxb0tfVG9rZW46R1hqOWJFcFFabzZ3aVp4S2pkMmN5TjRNbmJiXzE3NTUwNzczODc6MTc1NTA4MDk4N19WNA">
<h3 id="第三步访问你的api管理中心">第三步：访问你的API管理中心</h3>
当应用状态变为“运行中”，就代表你的 One-API 已经部署成功了！
<img src="https://fael3z0zfze.feishu.cn/space/api/box/stream/download/asynccode/?code=N2IwOWI2ZjgzYTIwZDhmYTYzYmZiYTliNjBmY2RjZWNfQ3FJWmlrQzV2eXN2cFZzYUhSekZ0T3Boa2piT0pIa2FfVG9rZW46RU1PTGJvMWJVb1FrYzh4eEx5b2NRZmRHblNjXzE3NTUwNzczODc6MTc1NTA4MDk4N19WNA">
点击详情
点击“公网地址”，系统会跳转到 One-API 的登录页面。默认的管理员账号是 <code>root</code>，密码是 <code>123456</code>。请务必在第一时间登录并修改密码！
<img src="https://fael3z0zfze.feishu.cn/space/api/box/stream/download/asynccode/?code=N2NmN2U1NjlhYWYxNTU5NzQxODI4MjNkOWU0ZWRjNGNfV1V0NDRZd0x5VDY0MlVtekhBT0JQMjNzd0xpb1hvbEtfVG9rZW46R0tQNGJrTXU5b2pvZUt4Qk8zWGNCY2t6bnNnXzE3NTUwNzczODc6MTc1NTA4MDk4N19WNA">
<img src="https://fael3z0zfze.feishu.cn/space/api/box/stream/download/asynccode/?code=OGZlOTM0MzViMTJhNjM0ODg4MzgzZTBmN2Y2Nzc4ZGZfZW0zSnlMNEVUMG9XSGlmMmg2aER4eGMzYmlsSHU3azNfVG9rZW46SnRHeWJXZFFtb0NCWG54UGZldmNoUXlpbkdiXzE3NTUwNzczODc6MTc1NTA4MDk4N19WNA">
<h3 id="快速上手添加渠道并生成令牌">快速上手：添加渠道并生成令牌</h3>
现在，让我们来完成最重要的两步，让你的 One-API 真正可用。
<ol>
<li>添加一个API渠道</li>
</ol>
“渠道”指的就是你要接入的具体大模型服务。
<ul>
<li>
在左侧菜单栏点击“渠道”。
</li>
<li>
点击“添加新的渠道”。
</li>
</ul>
<img src="https://fael3z0zfze.feishu.cn/space/api/box/stream/download/asynccode/?code=NDRkMjc1ZmE5MDI0N2Y0NmM2NjNkZmRhMzJiODBkYmVfV0NncnlCcDBOTXdjbFpQMVpRbUQ3M05SZ3d3WWNocnhfVG9rZW46RUQ3YmJrNzJpb0NkVnR4TFFNZWNBdmpPbjZkXzE3NTUwNzczODc6MTc1NTA4MDk4N19WNA">
<ul>
<li>
类型选择你拥有的模型服务，比如 <code>OpenAI</code>。
</li>
<li>
密钥中填入你自己的 OpenAI API Key。
</li>
<li>
根****URL 可以留空（默认使用官方地址），或者填入你的代理地址。
</li>
</ul>
<img src="https://fael3z0zfze.feishu.cn/space/api/box/stream/download/asynccode/?code=MDBlYWYwOTkzNDc1NWRhYTYzMzk1M2YyOTRmMWU2OTRfbW9FVFRMUnR3WDZSWEd6RVpPMEZHNXg4bEphbFhIcVhfVG9rZW46UUE4d2JTdm52b1NlQzd4QVYxcmNjUnNUbnBlXzE3NTUwNzczODc6MTc1NTA4MDk4N19WNA">
<ul>
<li>点击提交”。</li>
</ul>
<img src="https://fael3z0zfze.feishu.cn/space/api/box/stream/download/asynccode/?code=MzNiM2JiZTFkNjc1Y2Q5NzQ3N2I2ODM3OGJhNTZkN2VfdUdpRW5HVmpSMkd3azJ4dmtsWE1FQnRpbm90MGZNbmZfVG9rZW46WXFkdWJOd2RHb2preGV4Rmd6dWNHRk4xbk9nXzE3NTUwNzczODc6MTc1NTA4MDk4N19WNA">
<ol start="2">
<li>创建一个通用令牌</li>
</ol>
“令牌”就是你未来在所有应用中实际使用的、统一的API密钥。
<ul>
<li>
在左侧菜单栏点击“令牌”。
</li>
<li>
点击“添加新的令牌”。
</li>
</ul>
<img src="https://fael3z0zfze.feishu.cn/space/api/box/stream/download/asynccode/?code=N2M5NTkxMmRkOTdiMTYwNDVlMGZmZWJhZGMyZThlY2FfTnBXZzdXN01ZcUZRUDN2bFlnaTJOUFdHcUdXdjZuRVRfVG9rZW46TTBxeWJrVmltb29NaVB4Ujlkb2NUOGVabm9kXzE3NTUwNzczODc6MTc1NTA4MDk4N19WNA">
<ul>
<li>
给它起个好记的名称。
</li>
<li>
你可以设置它的额度和过期时间。
</li>
</ul>
<img src="https://fael3z0zfze.feishu.cn/space/api/box/stream/download/asynccode/?code=Zjk5YzJkZmI5MWY1N2I5NzAwNjNmOWQ4N2NkNDcwY2JfbXVsWG9WRDlHT1ZQREdYa25SRzFqRFBCMWs0YjJkaTVfVG9rZW46SXVDTmJqSXROb1duanh4TXU0Q2NpaDdhblFzXzE3NTUwNzczODc6MTc1NTA4MDk4N19WNA">
<ul>
<li>点击“提交”。</li>
</ul>
创建成功后，复制生成的令牌密钥，这个就是你以后要用的“万能钥匙”！
<img src="https://fael3z0zfze.feishu.cn/space/api/box/stream/download/asynccode/?code=ZDE2ODdhNTc5MWY5MjAxNDk5OGMyODliY2Q0MmY2OTNfRnpsdXE0WG54aEkxSXhCV213V2NzOUFBUjU3OHR1R0lfVG9rZW46TVVKZGJrREdkb3R4MXp4dmFRbGNOQ1kzbkFiXzE3NTUwNzczODc6MTc1NTA4MDk4N19WNA">
<h3 id="如何在你的代码中使用">如何在你的代码中使用？</h3>
现在，最神奇的部分来了。在你的任何应用或代码中，只需要修改两个地方：
<ol>
<li>
将 API 的 Base URL 修改为你在 Sealos 上部署的 One-API 的外网地址。
</li>
<li>
将 API Key 修改为你刚刚在 One-API 中生成的那个令牌 (Token)。
</li>
</ol>
然后，你就可以像调用原生OpenAI一样，调用所有你已添加到渠道中的模型了！
<img src="https://fael3z0zfze.feishu.cn/space/api/box/stream/download/asynccode/?code=OWNkMTBlM2E4MmJjZGNmYzVhMTBjMDJmZGVhOWYwZjhfNVJHZlRMUlVTZXQyZ2xvcnBadGFIWTNpNTB1dFI4MWhfVG9rZW46TzUyZWJGblBOb2RHeUh4eHg1Y2NPUjdRbjRlXzE3NTUwNzczODc6MTc1NTA4MDk4N19WNA">
<h3 id="总结">总结</h3>
通过 Sealos，我们再次轻松地将一个功能强大的开源项目变成了自己的私人服务。无论是搭建网站监控，还是管理复杂的AI密钥，Sealos 应用商店都为你提供了一条捷径。
告别密钥管理的混乱，现在就去 Sealos 应用商店部署你自己的 One-API 大管家吧！ 
来源：https://www.cnblogs.com/wwf0427/p/19036263

頁: [1]

琼殿技术论坛's Archiver

One-API 部署教程：用 Sealos 统一管理你的所有大模型密钥