自带密钥（BYOK）
BYOK（Bring Your Own Key，自带密钥）让组织把自己的官方厂商 API key 接入网关：推理直接用你自己的厂商额度、合同价与厂商账户，同时照享统一 API、智能路由与失败兜底。
BYOK 是什么
开启 BYOK 后，命中的模型调用会用你自己的 key 打厂商官方端点：推理费记在你自己的厂商账户，请求数据也留在你与厂商的既有协议之内——采购或合规要求直连厂商的场景尤其适用。
零锁定是设计原则：key 是你的，应用对接的是 OpenAI 兼容端点，任何时候都可以把 base_url 切回厂商官方端点直连。
怎么调用：一把 key 走天下
- 应用始终只用一把 BoostRail API key，靠请求里的 model 参数区分模型；BYOK 不需要在代码里新增任何 key。
- 存入的厂商 key 是「后台库存」，应用永不直接接触：网关发现该模型你放了自己的 key，就自动用你的 key 打官方端点，只计一次配额。
- 组织级共享：多把 BoostRail key（按应用/环境分开）共享同一套厂商 key、月配额与套餐。
- 完整优先级：你的 key（按序轮转，失败自动换下一把）→ 平台线路（默认允许，需钱包余额）→ 都不行才报错。
- 两种「用完」都自动切换：厂商账户额度耗尽（key 报错）→ 当场切平台；月请求配额用完 → 当月走平台，下月 1 日（UTC）恢复。全程应用代码零改动。
套餐
按预付次数额度包计费，不抽成、不绑卡、从不赊账：
| 档位 | 月费 | 月度 BYOK 请求数 | 可接服务商数 | 附赠平台额度 |
|---|---|---|---|---|
| 免费档 | $0 | 1,000,000 | 3 个 | — |
| 标准档 | $19 | 5,000,000 | 15 个 | 送 $5 |
| 高级档 | $99 | 20,000,000 | 不限 | 送 $20 |
- 套餐费从钱包余额扣——单次充值即可，无需绑卡订阅；自动续费可随时开关，不续即止、无违约金。
- 余额不足续不上时自动降为免费档，充值后可随时重新购买。
- 配额达 80% 与 100% 时会收到站内通知；用完后请求自动切换平台线路（按控制台公开的平台价计费，无隐藏加价），下月 1 日（UTC）配额恢复。
路由机理
- 优先段：你的 key 排在最前，按你设定的顺序尝试，永远先于平台线路。
- 平台兜底（默认开）：你的 key 全部失败或限流时，自动回退平台付费线路——无需申请或配置任何平台侧 key，钱包有余额即可。
- Always use：可按服务商设置只用你的 key、不回退平台（key 耗尽即报错），适合严格数据边界场景。
- 建议保持少量钱包余额作「兜底保险金」——可选，不充不影响免费额度使用。
支持的服务商
Anthropic、OpenAI、DeepSeek、Kimi（Moonshot）、GLM（智谱）、Qwen（阿里）、Grok（xAI）、Gemini（Google）、MiniMax 共 9 家，以控制台服务商列表为准、逐步开放。每家可配多把 key，支持优先级排序与自动轮换。
安全与信任
- key 加密存储（AES-256-GCM），接口与日志只回显尾 4 位，永不含完整密钥。
- 可随时轮换、删除 key——删除即时生效。
- 主动权在你手里：在厂商官方后台一键吊销或限额，即刻生效，不需要信任我们的任何承诺。
- key 按组织隔离，只用于你组织的请求；每次调用与 key 变更都有审计记录。
与平台线路配合更划算
- 平台线路价格通常低于官方牌价，具体折扣因模型而异——以控制台模型页公开实价为准。
- BYOK 覆盖不到的模型走平台线路即开即用，无需任何配置。
- 为什么有的模型覆盖不到：BYOK 路由要求服务商在支持名单内、且模型已登记官方端点映射；经聚合货源上架或厂商无公开官方 API 的模型只能走平台线路，覆盖随目录扩充增加。