自带 Key（BYOK）

开启 BYOK 后，对某款模型的请求会用你自己的厂商 Key，发到厂商的官方端点。推理费用记在你自己的厂商账号上，请求数据也留在你和厂商已有的协议范围内。采购或合规要求与厂商直接签约时，这一点很有用。

这样设计就不会被锁定：Key 是你的，应用对接的是 OpenAI 兼容端点。任何时候都可以把 base_url 改回厂商的官方端点。

• 应用始终只用一个 BoostRail API Key，用每个请求的 model 参数选模型。BYOK 不需要在代码里加任何新的 Key。
• 你存进来的厂商 Key 只在后台使用，应用不会接触到。你调用的模型有对应的 Key 时，BoostRail 用这个 Key 请求厂商的官方端点，并从你的配额里计一次请求。
• 厂商 Key 在组织内共用：按应用或环境分开的多个 BoostRail API Key，共用同一组厂商 Key、同一份月度配额和同一个套餐。
• 顺序：标为优先的 Key（按你设的顺序，失败就换下一个）→ 平台线路（默认开启，需要余额）→ 标为兜底的 Key → 全部失败才报错。
• 两种「用完」都会自动切换：厂商账号的余额用完时，请求当场改走平台线路；每月的 BYOK 配额用完时，请求改走平台线路，直到每月 1 日（UTC）配额重置，只能用自带 Key 的模型在此之前暂停。两种情况都不用改应用。

• 套餐费从钱包余额里扣，充值一次就够，不需要绑卡订阅。自动续费可以随时开关；关掉后，套餐到月底自然结束。
• 余额不够续费时，组织会自动回到免费套餐，充值后可以重新购买。
• 月度配额用到 80% 和 100% 时，控制台里会发通知。超出配额的请求改走平台线路，按公开的平台价格计费，没有隐藏加价；配额在每月 1 日（UTC）重置。

• 标为优先的 Key 排在最前，按你设的顺序尝试；一个 Key 失败，请求就换到下一个。
• 平台线路（默认开启）：优先的 Key 出错或被限流时，请求继续走同一模型的平台线路。只需要账户里有余额。
• 兜底 Key：标为兜底的 Key 在平台线路之后尝试。
• 只用自带 Key：可以按厂商关闭平台线路，适合数据边界要求严格的情况。你的 Key 用尽时，请求直接失败，不会回落。
• 钱包里留一点余额可以当作兜底，这是可选的，使用免费额度不需要余额。

Anthropic、OpenAI、DeepSeek、Kimi（月之暗面）、GLM（智谱）、Qwen（阿里）、Grok（xAI）、Gemini（Google）、MiniMax、Mistral、Cohere、Perplexity、AI21、Groq 和 Aion Labs，共十五家；后续还会开放更多，以控制台里的列表为准。每家厂商可以添加多个 Key，支持排序和自动轮换。

• Key 加密存储（AES-256-GCM）；界面和日志只显示最后四位，从不显示完整的 Key。
• Key 可以随时轮换或删除，删除立即生效。
• 控制权在你手里：随时可以在厂商自己的控制台吊销 Key 或设上限，立即生效，不需要相信我们的任何承诺。
• Key 按组织隔离，只用于本组织的请求。每次调用和每次 Key 变更都有审计记录。

• 在平台线路上，主流模型的价格不高于官方牌价。实时的 token 单价见模型页。
• BYOK 覆盖不到的模型，可以直接走平台线路，不用额外设置。
• 为什么有些模型覆盖不到：BYOK 要求厂商在支持名单里，并且这款模型能在该厂商的官方 API 上调用。其他模型只走平台线路；覆盖范围会随目录扩大。