CoreRouter API 文档桌面客户端接入
支持 OpenAI Compatible / 自定义 OpenAI 接口的客户端，一般都可以接入 CoreRouter。用户只需要在客户端里填写 Base URL、API Key 和模型 ID。
Cherry Studio
下载地址：https://cherryai.com.cn/download
配置步骤
- 下载并安装 Cherry Studio。
- 打开设置，进入模型服务或供应商配置页面。
- 新增一个 OpenAI Compatible 类型的服务。
- 填写下表信息并保存。
| 配置项 | 填写内容 |
|---|---|
| Provider / 类型 | OpenAI Compatible |
| API URL / Base URL | https://api.corerouter.tech/v1 |
| API Key | CoreRouter 控制台创建的 API Key |
| Model ID | 控制台中的模型 ID，例如 claude-sonnet-4-5 |
测试连接
- 新建对话。
- 选择刚配置的模型。
- 发送
你好，请介绍一下你自己。。 - 如果模型正常返回内容，说明客户端配置可用。
其他客户端
下面这些客户端也通常支持 OpenAI Compatible 配置：
| 客户端 | 配置方式 | Base URL 建议 |
|---|---|---|
| Chatbox | 自定义 OpenAI API 地址和 API Key | https://api.corerouter.tech/v1 |
| NextChat | 自定义接口地址 | 先试 https://api.corerouter.tech/v1，如重复拼接再改根地址 |
| Lobe Chat | 自定义 OpenAI 兼容 Provider | https://api.corerouter.tech/v1 |
| Open WebUI | OpenAI API Connections | https://api.corerouter.tech/v1 |
| AnythingLLM | OpenAI-compatible provider | https://api.corerouter.tech/v1 |
| Dify | OpenAI-API-compatible 模型供应商 | https://api.corerouter.tech/v1 |
如果客户端要求填写完整 API 地址，优先使用 https://api.corerouter.tech/v1。如果客户端自动拼接 /v1/chat/completions，则只填写 https://api.corerouter.tech。
兼容性边界
不是所有写着“支持自定义模型”的客户端都适合直接接入。判断标准是：客户端必须允许填写自定义 Base URL、API Key 和 Model ID，并且请求格式要能使用 OpenAI Compatible、Anthropic Messages 或 Gemini-compatible 中的一种。
| 客户端类型 | 兼容结论 | 说明 |
|---|---|---|
| OpenAI Compatible 客户端 | 推荐支持 | 例如 Cherry Studio、Chatbox、Lobe Chat、Open WebUI、AnythingLLM、Dify。基础聊天通常可用，高级能力取决于模型和客户端实现。 |
| 自动拼接 OpenAI 路径的客户端 | 条件支持 | Base URL 需要填根地址 https://api.corerouter.tech，避免出现 /v1/v1 或重复路径。 |
| 只支持官方账号登录的客户端 | 不支持 | 如果不能填写 Base URL 和 API Key，就不能作为自定义中转接口接入。 |
| 只支持固定官方模型列表的客户端 | 不建议承诺支持 | 即使能填 Key，也可能无法添加控制台里的 Model ID。 |
| Cursor | 暂不作为正式支持客户端 | Cursor 的自定义 API Key 主要面向聊天模型，Tab、内置 Agent、模型路由和部分高级能力不一定走自定义 Base URL。除非你针对某个版本完整测试，否则不要在文档中承诺支持。 |
| 只支持 Responses API 的客户端 | 条件支持 | 必须选择控制台中支持 Responses 的 Model ID，普通聊天模型不能直接使用。 |
| 需要 Realtime WebSocket 的客户端 | 条件支持 | 必须支持自定义 WebSocket URL、认证方式和 Realtime 模型。普通 HTTP Base URL 配置不能代替 Realtime。 |
| 强依赖 Assistants、Threads、Files、Batches 或 Vector Stores 的客户端 | 不支持对应高级功能 | 这些资源管理接口没有作为通用中转入口开放；只能使用客户端提供的 Chat、Responses 或其他已说明协议。 |
功能兼容说明
| 功能 | 是否可直接承诺 |
|---|---|
| 基础聊天 | 可以，前提是客户端支持 OpenAI Compatible。 |
| 流式输出 | 条件支持，取决于模型、渠道和客户端是否支持 SSE。 |
| Tool Calling / Agent | 条件支持，需要模型和客户端都支持工具调用。 |
| Vision / 图片输入 | 条件支持，需要选择视觉模型，并确认客户端按 OpenAI 图像输入格式发送。 |
| Embeddings | 条件支持，需要客户端能单独配置 Embeddings 模型。 |
| Rerank | 条件支持，需要客户端能配置 Rerank Endpoint 和模型。多数聊天客户端不会调用这个接口。 |
| Realtime 语音 | 条件支持，需要 WebSocket Realtime 支持。只支持 SSE 流式输出的客户端不等于支持 Realtime。 |
| 图片生成、音频、TTS | 不建议对所有客户端承诺，很多聊天客户端不会暴露这些接口。 |
Anthropic count_tokens 等辅助请求 | 条件受限 |
通用配置模板
| 字段名可能叫做 | 填写内容 |
|---|---|
| Provider / Model Provider / Type | OpenAI Compatible 或 Custom OpenAI |
| API URL / Base URL / Endpoint | https://api.corerouter.tech/v1 |
| API Key / Token / Secret Key | CoreRouter 控制台创建的 API Key |
| Model / Model ID / Deployment | 控制台中的模型 ID |
| Streaming | 建议开启，前提是模型支持 Streaming |
如果客户端要求手动添加模型，请复制控制台中的 Model ID。不要使用展示名称、中文名称或带空格的名称。
模型 ID 怎么填
请填写 CoreRouter 控制台显示的 Model ID。
- 正确：
claude-sonnet-4-5 - 错误：
Claude Sonnet - 错误：
claude sonnet 4.5
常见问题
模型列表为空
可能原因：
- API Key 无效或复制不完整。
- Base URL 填错。
- 账户没有可用模型。
- 客户端要求根地址，但填写了带
/v1的地址，或反过来。
建议先用 curl 查询模型：
bash
curl https://api.corerouter.tech/v1/models \
-H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx"
Base URL 应该带不带 /v1
判断方法：
- 客户端字段叫 Base URL、OpenAI Base URL，一般填写
https://api.corerouter.tech/v1。 - 客户端字段叫 API Host、Proxy URL，且说明会自动拼接 OpenAI 路径，可以填写
https://api.corerouter.tech。 - 报错里出现
/v1/v1，说明多填了一次/v1。 - 报错里只有根路径，说明客户端没有自动拼接，需要改成带
/v1。
发送消息无响应
检查 Model ID 是否存在、账户额度是否充足、模型或渠道是否可用。也可以换一个模型测试，确认是模型问题还是客户端配置问题。
图片、语音或 Embeddings 不可用
聊天模型可用不代表媒体或向量接口可用。请在控制台选择对应能力的模型，并确认客户端把请求发到了正确 Endpoint。
API Key 安全
- 不要在公共电脑保存 API Key。
- 不要把 API Key 放进截图、视频、公开笔记或公开仓库。
- 可以为不同设备创建独立 API Key，并设置额度上限。
- 如果 API Key 泄露，请在控制台禁用或删除后重新创建。