外观
客户端配置
大多数支持“OpenAI Compatible”或“自定义 OpenAI API 地址”的客户端都可以接入 Nexly API。
默认 Base URL
日常使用填写 https://nexly.guangnian.xin。Nexly API 会根据客户端请求自动识别接口，无需在 Base URL 后添加 /v1。
先确认地址类型
不同客户端对 Base URL 的定义不完全相同。填写前先判断它需要哪一种地址：
| 界面字段或使用场景 | 填写内容 |
|---|---|
SDK 的 base_url / baseURL | https://nexly.guangnian.xin |
| 客户端的 Base URL / API Host | https://nexly.guangnian.xin |
| 直接发送 HTTP 请求 | 服务根地址加完整路径，例如 https://nexly.guangnian.xin/v1/chat/completions |
| 完整接口 URL 模式 | https://nexly.guangnian.xin/v1/chat/completions |
服务根地址不包含接口路径。SDK 和客户端会自行拼接路径，而 HTTP 示例与 OpenAPI 已写明 /v1/...，使用时不要重复追加。本文保留 Nexly 的无 /v1 Base URL 接入约定；若某个客户端版本仍报 404，请先检查它最终发出的完整 URL，再核对该客户端的拼接规则，不要仅凭字段名称猜测。
不要默认填写完整接口路径
除非客户端明确要求“完整 URL”，否则不要在 Base URL 后添加 /v1、/chat/completions 或 /responses。Nexly API 会识别客户端实际发出的接口路径。
通用配置项
| 配置项 | 填写内容 |
|---|---|
| API 类型 / Provider | OpenAI / OpenAI Compatible |
| API Key | Nexly API 控制台创建的 Key |
| Base URL | https://nexly.guangnian.xin |
| 模型 | /v1/models 返回的模型 id |
| Chat 接口 | /chat/completions |
| Responses 接口 | /responses，仅在模型和客户端都支持时使用 |
通用配置步骤
在 Cherry Studio、Chatbox、NextChat、LobeChat 等客户端中，一般按以下步骤配置：
- 新建一个提供商。
- 类型选择 OpenAI或OpenAI Compatible。
- 名称填写
Nexly API，便于与官方提供商区分。 - 填入单独为该客户端创建的 API Key。
- Base URL 填写
https://nexly.guangnian.xin。 - 点击 获取模型；如果客户端不支持自动获取，则手动填写模型 ID。
- 保存配置并将 Nexly 设为当前提供商。
- 新建会话，发送“只回复连接成功”进行验证。
完成标志：模型列表可读取、测试消息返回正常、控制台能看到对应请求记录。
选择协议
客户端可能同时提供 Chat Completions 和 Responses 两种协议：
- 普通聊天客户端优先选择 Chat Completions，兼容范围更广。
- Codex 等原生使用 Responses 的工具优先选择 Responses。
- 如果
/v1/responses返回404或模型不支持，应切换为 Chat Completions，或使用 CC Switch 的本地协议转换。
模型支持哪些能力，应以实际请求结果和模型与能力说明为准。
验证 Base URL
保存客户端配置前，可以先用同一个 Key 验证服务根地址：
bash
curl --fail-with-body https://nexly.guangnian.xin/v1/models \
-H "Authorization: Bearer $NEXLY_API_KEY"如果命令成功但客户端失败，问题通常在客户端的路径拼接、代理、协议选择或模型配置，而不是 Key 本身。
CC Switch
如果同时使用 Codex、Claude Code 等命令行工具，推荐通过 CC Switch 管理不同供应商：
常见问题
请求路径出现重复或异常
确认 Base URL 只填写 https://nexly.guangnian.xin，不要手动追加 /v1 或具体接口路径。如果客户端要求填写“完整接口 URL”，再使用文档中对应接口的完整地址。
模型列表为空
- 用上面的 cURL 命令确认 Key 能查询
/v1/models。 - 检查 Base URL 是否只填写 Nexly API 根域名。
- 确认 Key 有模型权限且账号状态正常。
- 如果自动获取仍失败，手动填写响应中的模型
id。
测试连接成功但对话失败
“测试连接”可能只验证 /v1/models。继续检查模型是否支持 /v1/chat/completions、消息格式是否正确，以及客户端选择的协议。
浏览器提示 CORS
优先启用客户端的服务端代理模式。纯浏览器应用会受到跨域策略限制，也不适合保存长期 Key。生产项目应由自己的服务端调用 Nexly API。