其他 OpenAI 兼容客户端接入 LYRouter：配置与故障排查

Cherry Studio、Chatbox、LobeChat、NextChat、Cline、Continue 等支持「自定义 OpenAI 接口」的客户端，接入 LYRouter 的方法都一样：添加一个 OpenAI 类型的自定义服务商，地址填 https://api.lyrouter.com/v1，密钥填 LYRouter API Key，再添加要用的模型 ID。本页说明通用的填写方法和常见问题。

已经知道怎么添加自定义服务商？直接查看配置 LYRouter。

适用的客户端

只要客户端满足下面任一条件，就可以按本页接入：

• 能添加自定义服务商，并选择 OpenAI 或 OpenAI 兼容 类型；
• 能修改 OpenAI 的 API 地址（也可能叫 Base URL、API Host、接口地址或端点）。

开始前准备好两样东西：一把 LYRouter API Key，见创建工作空间与 API Key；以及要使用的模型 ID，从工作空间的 模型广场 复制，见如何选择模型。Claude Code、Codex 等工具有单独的接入指南，见工具兼容性与接入总览。

配置 LYRouter

在客户端的服务商设置中添加一个自定义服务商，按下表填写：

• 地址是否带 /v1：多数客户端需要填 https://api.lyrouter.com/v1。少数客户端会自动在地址后面补 /v1，这时只填根地址 https://api.lyrouter.com。如果字段要求填写完整请求地址，就填 https://api.lyrouter.com/v1/chat/completions。
• 模型列表：客户端「获取模型列表」时调用的是 GET /v1/models，返回的是这把 API Key 所属工作空间已开通的模型，以及已启用的虚拟模型和 lyrouter/auto。客户端不支持获取列表时，手动添加模型 ID。模型 ID 区分大小写，包含的斜杠要原样保留。
• 客户端支持 Anthropic 类型时：如果服务商类型选的是 Anthropic，地址填根地址 https://api.lyrouter.com，不加 /v1。

验证首次调用

在客户端中选中刚添加的模型，发送「请回复 OK」这样的简短消息。收到回复后，到工作空间的 日志分析 页按 API Key 找到这次请求，确认「API 路径」为 /v1/chat/completions、状态码为 200。日志在调用结束后几秒内可以查到。

只点「检查连接」或获取模型列表，不会产生对话请求，也不能证明对话已经可以正常使用。

日常使用与故障排查

返回 404，地址应该怎么改？

答： 地址少写了 /v1，或者客户端自动补了一次 /v1 导致路径重复。在 https://api.lyrouter.com/v1 和 https://api.lyrouter.com 之间切换试一次。能在日志中查到请求时，「API 路径」应为 /v1/chat/completions。

模型列表里没有想用的模型，怎么办？

答： 先确认模型已在这把 API Key 所属工作空间的模型广场中开通，再在客户端里手动添加模型 ID。安全围栏的模型策略禁止的模型不会出现在列表中，见模型授权。

返回 401，应该检查什么？

答： 确认填的是 LYRouter API Key，而不是服务商的 API Key 或控制台登录密码，并检查复制时没有多余的空格或换行。各报错原文的含义见401 / 403：鉴权与权限。

返回 403 Model is not available in the model plaza，是什么原因？

答： 请求的模型在这把 API Key 所属的工作空间里没有开通，或者模型 ID 写错了。核对模型 ID 的拼写和大小写，或请工作空间管理员在模型广场开通该模型，见模型不可用。

流式回复中途断开或格式错乱，怎么办？

答： 确认客户端开启的是流式输出，并检查网络代理是否会缓冲或截断长连接。网关在输出开始后不会切换通道，中途失败时会在流的末尾补发一个错误事件，见超时与流式中断。

应用有回复，但 LYRouter 日志里找不到请求，怎么办？

答： 确认客户端当前使用的是刚添加的 LYRouter 服务商，而不是其他服务商。日志按工作空间显示，请在 API Key 所属的工作空间中按时间和 API Key 查找，见通过日志定位调用问题。