BYOK（Bring Your Own Key）让你在 Nexior / Studio 的对话界面里，直接使用自己已有的上游服务商 API Key，完全绕开平台的账号池和积分计费。配置后该模型的对话请求会用你的 Key 直接打到 OpenAI / Anthropic / Google / xAI / DeepSeek / Moonshot / Zhipu —— 平台只做转发和工具拼装，不消耗任何积分。
适合场景：你已经有上游账号 + 余额，希望复用平台的 UI（云历史、Artifacts、引用、工具调用、Connector），但不想按平台的零售价付钱。
支持的提供商
| Provider | 上游接口 | Key 前缀 |
|---|---|---|
| OpenAI | https://api.openai.com/v1 |
sk- |
| Anthropic | https://api.anthropic.com |
sk-ant- |
| Google Gemini | https://generativelanguage.googleapis.com |
AIza... |
| xAI Grok | https://api.x.ai/v1 |
xai- |
| DeepSeek | https://api.deepseek.com |
sk- |
| Moonshot | https://api.moonshot.cn/v1 |
sk- |
| Zhipu (GLM) | https://open.bigmodel.cn/api/paas/v4 |
xxx.xxx |
每个 Provider 可保存多把 Key（例如个人 Key + 公司 Key），并通过 Label 区分。
5 分钟实操
第 1 步：打开 BYOK 设置
登录 studio.acedata.cloud → 右上角头像 → Settings → Custom API Key。
第 2 步：添加一把 OpenAI Key
- 点 Add API Key；
- Provider 选
OpenAI； - Label（可选）：
My Work ID； - API Key：粘贴你的
sk-...； - Custom Base URL（可选）：留空走官方地址；如要走代理（例如
https://openai.acedata.cloud），把整段 base URL 填这里； - 勾选 Active 后保存。
第 3 步：开始对话
回到聊天，模型选 gpt-5.5 / gpt-5-pro / gpt-4.1 任一 OpenAI 模型，发一条消息。Studio 会优先匹配你已激活的 BYOK Key，并在对话顶部显示 BYOK · OpenAI 徽章 —— 看到这个徽章说明这条对话没消耗平台积分。
如果同一 Provider 有多把 Key，Studio 会按最近使用 + Label 优先选；你也能在徽章上点击切换。
注意事项
- 只覆盖该 Provider 的模型：例如配置 OpenAI Key 只影响 GPT 系列，切到 Claude 仍会扣平台积分（除非你也配了 Anthropic Key）。
- 工具调用、引用、Artifacts、Connector 不受影响：这些都是平台侧的能力，不论是否走 BYOK 都正常工作。
- 错误处理透明：上游 401 / 429 / 5xx 会原样返回到对话，让你能直接看到上游 Key 的状态。
- Key 加密保存：平台只在转发请求时解密；不写日志、不会出现在客户端。
- 临时停用：把 Active 关掉而不删，下一条对话立即回退到平台积分计费。
- 不支持流式生效切换：对话进行中不会改用 BYOK，新建对话或刷新页面后生效。
常见问题
Q：自定义 Base URL 怎么配？
A：场景 1（境内代理）：填 https://openai.acedata.cloud/v1，请求会先走 AceData Cloud 边缘再到 OpenAI；场景 2（私有网关）：填你公司内部的 OpenAI 兼容网关。注意末尾不要带斜杠、不要带 /chat/completions。
Q：能跟订阅 / 充值并存吗？
A：能。BYOK 优先于积分计费；当 BYOK Key 失效（401）时不会自动 fallback 到积分，会直接报错让你修 Key。
Q：能管理团队成员的 Key 吗？
A：当前 BYOK 是个人维度的。团队 / 站长可以在 Subsite 维度统一配置上游账号池，请参考 Subsite 教程。
相关链接
- Studio 在线体验
- Connector 教程
- Subsite 白标教程
