平台模型与 BYOK 如何选择

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

两种来源对比

图 1：模型广场的「接入来源」可以按「三方服务」或「BYOK」筛选模型来源。 截图为演示数据，点击图片可查看原图。

什么时候用哪种

适合直接使用平台来源：

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

适合接入 BYOK：

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

两种来源如何一起工作

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

开始接入 BYOK

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

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

图 2：接入 BYOK 的第一步：选择服务商和计费方式。 截图为演示数据，点击图片可查看原图。

常见问题

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

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

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

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

图像生成模型能用 BYOK 吗？

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