自定义密钥

如何使用自己的 API 密钥?

连接你自己的 AI 提供商账户,让队友通过你的 API 预算或订阅运行。

什么是 BYOK(使用自己的密钥)?

默认情况下,Helio 中的 AI 队友通过 Helio 托管的访问运行——Helio 提供 API 连接,使用费用计入你的 Helio 套餐。使用自己的密钥(也叫 bring-your-own-key,BYOK)可以让你改为连接自己的 Anthropic、OpenAI 或 DeepSeek 账户——用 API 密钥,或者已有的 Claude Code、ChatGPT 订阅——这样队友的使用量就走你自己的预算和账户,而不是 Helio 托管访问。

Live preview

为什么使用自己的密钥很重要

问题:Helio 托管访问不适合所有场景

Helio 托管访问作为默认选项很好用,但不是每个团队都适合。有些团队已经自己付费使用 Anthropic、OpenAI 或 DeepSeek 账户,不想再产生一份账单。有些团队已经有 Claude Code 或 ChatGPT 订阅,闲置在那里没有用上。有些需要只能通过直接 API 访问才能用到的模型。还有些希望所有调用都走自己能控制的账户,而不是共用账户。

方案:带入自己的凭据

使用自己的密钥,把服务商凭据——API 密钥或 subscription login——连接到你的工作区,再分配给需要用它的 AI 队友。从那一刻起,这个队友的使用量就计入你自己的账户,而不是 Helio 托管访问。

使用自己的密钥如何运作

凭据存储在 Helio 的凭据库中,静态加密,仅用于代表 AI 队友进行 API 调用——初次输入后,Helio 不会再次显示凭据值。每位 AI 队友使用一组凭据:让多个队友选择同一个工作区凭据即可共享一份服务商预算,也可以为每位队友设置各自的凭据。邀请真人成员不会自动导入对方自己的 API 密钥。

支持的凭据类型

提供商选项
AnthropicAPI 密钥,或 Claude Code 订阅
OpenAIAPI 密钥,或 ChatGPT 订阅
DeepSeekAPI 密钥

真实场景

  • 已经有 Anthropic 或 OpenAI 账户? 直接连接 API 密钥,让 Claude Code 或 Codex 队友使用你自己的账户和账单运行,而不是走 Helio 托管访问。
  • 已经在付费使用 Claude Code 或 ChatGPT 订阅? 用 subscription login 代替单独的 API 密钥,避免重复付费。
  • 想要更省成本的模型访问? 连接 DeepSeek API 密钥,获得更经济的兼容模型访问。
  • 不同团队或项目需要分开预算? 添加多个带清晰标签的工作区凭据,比如 prod-anthropicgrowth-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 来添加。

本节全部内容

On this page