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

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

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

已经知道怎么添加自定义服务商？直接查看[配置 LYRouter](#配置-lyrouter)。

## 适用的客户端

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

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

开始前准备好两样东西：一把 LYRouter API Key，见[创建工作空间与 API Key](https://platform.lyrouter.com/ai_gateway/docs/api-keys)；以及要使用的模型 ID，从工作空间的 **模型广场** 复制，见[如何选择模型](https://platform.lyrouter.com/ai_gateway/docs/choose)。Claude Code、Codex 等工具有单独的接入指南，见[工具兼容性与接入总览](https://platform.lyrouter.com/ai_gateway/docs/tools)。

## 配置 LYRouter

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

| 字段 | 填写 |
| --- | --- |
| 服务商类型 | OpenAI 或 OpenAI 兼容 |
| API 地址 | `https://api.lyrouter.com/v1` |
| API 密钥 | LYRouter API Key（`sk-` 开头） |
| 模型 | 手动添加模型 ID，例如 `deepseek/deepseek-v4-flash`；也可以填 `@vmodel/<名称>` 或 `lyrouter/auto` |

- **地址是否带 `/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。安全围栏的模型策略禁止的模型不会出现在列表中，见[模型授权](https://platform.lyrouter.com/ai_gateway/docs/authorization)。

### 返回 401，应该检查什么？

**答：** 确认填的是 LYRouter API Key，而不是服务商的 API Key 或控制台登录密码，并检查复制时没有多余的空格或换行。各报错原文的含义见[401 / 403：鉴权与权限](https://platform.lyrouter.com/ai_gateway/docs/auth-errors)。

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

**答：** 请求的模型在这把 API Key 所属的工作空间里没有开通，或者模型 ID 写错了。核对模型 ID 的拼写和大小写，或请工作空间管理员在模型广场开通该模型，见[模型不可用](https://platform.lyrouter.com/ai_gateway/docs/unavailable)。

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

**答：** 确认客户端开启的是流式输出，并检查网络代理是否会缓冲或截断长连接。网关在输出开始后不会切换通道，中途失败时会在流的末尾补发一个错误事件，见[超时与流式中断](https://platform.lyrouter.com/ai_gateway/docs/stream-errors)。

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

**答：** 确认客户端当前使用的是刚添加的 LYRouter 服务商，而不是其他服务商。日志按工作空间显示，请在 API Key 所属的工作空间中按时间和 API Key 查找，见[通过日志定位调用问题](https://platform.lyrouter.com/ai_gateway/docs/logs)。