如何使用自己的 API 密钥?
连接你自己的 AI 提供商账户,让队友通过你的 API 预算或订阅运行。
什么是 BYOK(使用自己的密钥)?
默认情况下,Helio 中的 AI 队友通过 Helio 托管的访问运行——Helio 提供 API 连接,使用费用计入你的 Helio 套餐。使用自己的密钥(也叫 bring-your-own-key,BYOK)可以让你改为连接自己的 Anthropic、OpenAI 或 DeepSeek 账户——用 API 密钥,或者已有的 Claude Code、ChatGPT 订阅——这样队友的使用量就走你自己的预算和账户,而不是 Helio 托管访问。
为什么使用自己的密钥很重要
问题:Helio 托管访问不适合所有场景
Helio 托管访问作为默认选项很好用,但不是每个团队都适合。有些团队已经自己付费使用 Anthropic、OpenAI 或 DeepSeek 账户,不想再产生一份账单。有些团队已经有 Claude Code 或 ChatGPT 订阅,闲置在那里没有用上。有些需要只能通过直接 API 访问才能用到的模型。还有些希望所有调用都走自己能控制的账户,而不是共用账户。
方案:带入自己的凭据
使用自己的密钥,把服务商凭据——API 密钥或 subscription login——连接到你的工作区,再分配给需要用它的 AI 队友。从那一刻起,这个队友的使用量就计入你自己的账户,而不是 Helio 托管访问。
使用自己的密钥如何运作
凭据存储在 Helio 的凭据库中,静态加密,仅用于代表 AI 队友进行 API 调用——初次输入后,Helio 不会再次显示凭据值。每位 AI 队友使用一组凭据:让多个队友选择同一个工作区凭据即可共享一份服务商预算,也可以为每位队友设置各自的凭据。邀请真人成员不会自动导入对方自己的 API 密钥。
支持的凭据类型
| 提供商 | 选项 |
|---|---|
| Anthropic | API 密钥,或 Claude Code 订阅 |
| OpenAI | API 密钥,或 ChatGPT 订阅 |
| DeepSeek | API 密钥 |
真实场景
- 已经有 Anthropic 或 OpenAI 账户? 直接连接 API 密钥,让 Claude Code 或 Codex 队友使用你自己的账户和账单运行,而不是走 Helio 托管访问。
- 已经在付费使用 Claude Code 或 ChatGPT 订阅? 用 subscription login 代替单独的 API 密钥,避免重复付费。
- 想要更省成本的模型访问? 连接 DeepSeek API 密钥,获得更经济的兼容模型访问。
- 不同团队或项目需要分开预算? 添加多个带清晰标签的工作区凭据,比如
prod-anthropic或growth-openai,再给每位 AI 队友分配对应的凭据。 - 想要多个队友共用一份服务商预算? 添加一个工作区凭据,让多个 AI 队友选择这个凭据下的模型。
好处
| 好处 | 说明 |
|---|---|
| 成本控制 | 通过你自己的 API 账户路由使用,使用你自己的限额和计费 |
| 复用现有订阅 | 直接使用你已经付费的 Claude Code 或 ChatGPT 订阅 |
| 特定模型访问 | 解锁只能通过直接 API 访问的模型 |
| 隐私偏好 | 所有调用都通过你自己的账户 |
使用自己密钥的建议
| 建议 | 说明 |
|---|---|
| 标签写清楚 | 用标签说明这份预算属于谁或用于什么场景,比如 prod-anthropic——这是之后队友在模型选择器里看到的内容 |
| key 要和 provider 匹配 | 即使模型名看起来相似,粘贴的 key 也必须和生成它的服务商一致 |
| 分配前先确认引擎兼容 | Anthropic key 主要用于 Claude Code 队友,OpenAI key 主要用于 Codex 队友——分配前先确认队友引擎兼容 |
| 换密钥而不是复用 | 如果 key 泄露、过期或需要换 owner,先在服务商控制台轮换,再回 Helio 更新凭据 |
常见问题
邀请真人成员会共享对方的个人 API 密钥吗? 不会。邀请真人成员不会自动导入对方自己的 Anthropic、OpenAI 或 DeepSeek 密钥——工作区凭据需要由工作区管理员单独添加。
能不能用订阅代替 API 密钥? 可以,Claude Code 和 ChatGPT 都支持。如果你已经付费使用其中一个订阅,可以用 subscription login 代替单独的 API 密钥。
保存后 Helio 还会再显示我的 API 密钥吗? 不会。提交后 Helio 不会再次显示 API key 明文。如果 key 泄露、过期或需要换 owner,请先在服务商控制台轮换,再回 Helio 更新凭据。
多个 AI 队友能共用同一个凭据吗? 可以。让多个 AI 队友选择同一个工作区凭据,就能共用一份服务商预算;也可以为每位队友设置各自的凭据分开计费。
如果我的服务商不在内置列表里,比如 DeepSeek,怎么办? 以兼容的自定义 endpoint 方式接入。比如 DeepSeek 就不在内置服务商列表里(OpenAI、Anthropic、OpenRouter、AWS Bedrock、Azure),需要通过 Custom 选项填写它的 API endpoint 来添加。
Anthropic API 密钥
连接你的 Anthropic 账户或 API 密钥。
OpenAI API 密钥
连接你的 OpenAI 账户或 API 密钥。
DeepSeek
连接你的 DeepSeek API 密钥。
共享 API 凭据
说明成员加入后,哪些 API 凭据会共享,哪些不会。
订阅登录
使用你的 Claude Code 或 ChatGPT 订阅。