# 平台模型与 BYOK 如何选择

来源: https://platform.lyrouter.com/ai_gateway/docs/byok-choice
更新日期: 2026-10-14

LYRouter 的模型有两种来源：平台来源使用 LYRouter 提供的服务商通道和凭证，按用量从 Credits 余额扣费；BYOK（Bring Your Own Key，自带密钥）使用你在服务商处的 API Key，上游费用由服务商向你收取，LYRouter 对每次成功的 BYOK 调用收取一笔固定服务费。两种来源用同一个 LYRouter API Key、同一个模型 ID 调用，可以同时存在，由网关按路由规则选择。

## 两种来源对比

| 比较项 | 平台来源 | BYOK |
| --- | --- | --- |
| 需要准备 | Credits 余额 | 服务商账号和 API Key（按量 API 或 Coding Plan） |
| 在哪里配置 | **模型广场** 开通模型 | **自带密钥（BYOK）** 添加通道 |
| 上游费用 | 按平台价从 Credits 扣除 | 服务商按你的账户收取 |
| LYRouter 收费 | 按用量扣 Credits | 每次成功调用扣一笔固定的服务费 |
| 支持的模型 | 平台提供的全部模型，包括图像、视频、语音和向量模型 | 只支持输出为文本的对话模型 |
| 可接入的服务商 | 平台已上架的服务商 | 「模型官方服务商」列表中的服务商，以及任意自定义服务商 |
| 额度与并发 | 平台通道的额度 | 你在服务商处的账户额度和并发 |
| 模型广场「接入来源」 | 「三方服务」 | 「BYOK」 |

（截图：模型广场的「接入来源」可以按「三方服务」或「BYOK」筛选模型来源。）

## 什么时候用哪种

适合直接使用平台来源：

- 不想管理服务商账号，开通模型即可调用。
- 需要图像、视频、语音或向量模型。
- 希望所有费用都用 Credits 统一结算。

适合接入 BYOK：

- 已有服务商的按量额度、折扣或 Coding Plan 订阅，希望继续使用。
- 需要平台没有提供的服务商，或要接入企业自建代理、聚合平台，用「自定义服务商」接入。
- 有合规要求，调用必须经过指定的服务商账号，配合「仅用此 BYOK」使用。
- 需要更高并发，可以在一个 BYOK 下添加多个不同账户的 API Key。

## 两种来源如何一起工作

- **同一个模型 ID**：客户端不需要区分来源。BYOK 配置生效后，模型在模型广场自动获得 BYOK 来源并默认开通；可以在模型详情页的「服务商与价格」中按来源开关。
- **同一通道内 BYOK 在前**：内置服务商的 BYOK 与平台来源共用该服务商的通道。网关进入一个通道后，先按你设置的顺序尝试 BYOK 凭证，再尝试平台凭证。自定义服务商是独立的通道，与其他通道一起按多渠道选路策略排序，见[通道选择与路由策略](https://platform.lyrouter.com/ai_gateway/docs/routing)。
- **固定使用 BYOK**：在 BYOK 的「使用配置」中开启「优先使用此 Channel」，让所选模型先走这个通道；开启「仅用此 BYOK」则不再使用平台凭证、其他通道或默认模型，模型广场中该通道的平台来源显示「仅允许 BYOK」。
- **余额仍然需要**：BYOK 调用前网关会从余额中预留服务费，余额不足时返回 402 `insufficient credit balance`，不会改用平台来源，见[BYOK 费用与凭证管理](https://platform.lyrouter.com/ai_gateway/docs/byok-cost)。

## 开始接入 BYOK

1. 准备服务商的 API Key。服务商同时提供按量 API 和 Coding Plan 时，先确认要接入哪一种，见[API 按量服务与 Coding Plan](https://platform.lyrouter.com/ai_gateway/docs/coding-plan)。
2. 由当前账号管理员在工作空间的 **自带密钥（BYOK）** 页面接入，步骤见[接入 BYOK 与测试连接](https://platform.lyrouter.com/ai_gateway/docs/byok)。普通成员看不到这个页面，用自己的 API Key 即可调用账号管理员配置好的 BYOK 来源。
3. 自定义服务商需要把上游模型对应到系统模型，见[模型映射与来源配置](https://platform.lyrouter.com/ai_gateway/docs/mapping)。

只能使用服务商发放的 API Key。网页版账号的登录态或 Cookie 不能作为 BYOK 凭证。

（截图：接入 BYOK 的第一步：选择服务商和计费方式。）

## 常见问题

### 同一个模型既有平台来源又有 BYOK，调用时先用哪个？

**答：** 内置服务商的同一个通道内先用 BYOK 凭证，再用平台凭证；不同通道之间按多渠道选路策略排序。需要固定先走 BYOK 时，在 BYOK 中开启「优先使用此 Channel」。调用后在[请求日志](https://platform.lyrouter.com/ai_gateway/docs/logs)中查看，「服务商」旁带「BYOK」标记的就是走了 BYOK。

### 我要的服务商不在「模型官方服务商」列表中，怎么接入？

**答：** 选择「自定义服务商」，填写服务商的 Base URL 和接口类型。OpenAI、Anthropic 等服务商也通过这种方式接入。上游模型必须对应到平台模型目录中已有的文本对话模型，见[模型映射与来源配置](https://platform.lyrouter.com/ai_gateway/docs/mapping)。

### 图像生成模型能用 BYOK 吗？

**答：** 不能。BYOK 只支持输出为文本的对话模型（可以接受图片输入），图像、视频、语音和向量模型请使用平台来源。