切换深色模式
接入聊天客户端
如果聊天软件支持自定义 API 地址和 OpenAI 兼容接口，通常可以通过本站地址、API Key 和模型 ID 进行接入。
本页介绍通用填写方法。不同软件版本的菜单名称和路径补全规则可能不同，请结合客户端自身说明操作。
接入前准备
第一步：添加服务提供商
进入客户端的「设置」「模型服务」「服务商」或类似入口，选择支持 OpenAI 兼容接口的提供商类型，必要时新建自定义提供商。
服务商名称可以填写 Undy API，方便与其他服务区分。
第二步：填写接入参数
API Key
粘贴完整令牌。普通的 API Key 输入框一般不需要手动填写 Bearer 前缀，也不要填写账号密码。
API 地址
填写规则
先查看客户端字段的说明和示例：
| 客户端要求 | 本文示例 |
|---|---|
服务根地址，并自动追加 /v1 | https://api.example.com |
| Base URL，并在其后追加接口路径 | https://api.example.com/v1 |
| 完整聊天补全请求地址 | https://api.example.com/v1/chat/completions |
确认最终请求路径
对于本文的 Chat Completions 示例，最终请求应发送到：
text
https://api.example.com/v1/chat/completions如果请求变成了 /v1/v1/chat/completions，通常是版本路径被重复拼接。调整地址填写方式后重新测试。
使用真实 API 地址
示例域名不能直接用于调用。请使用本站控制台提供的地址，而不是当前文档站的网址。
模型
如果客户端可以获取模型列表，刷新后选择需要的模型；如果不能自动获取，可以手动添加准确的模型 ID。
模型列表为空时，不要随意填写一个模型名称。先检查地址、令牌权限和本站实际开放的模型。
第三步：发送测试消息
- 保存服务商设置。
- 新建一个对话。
- 选择刚配置的服务商和模型。
- 发送一句简短消息。
- 收到回复后，在控制台核对调用记录。
常见接入问题
测试连接成功，但聊天失败
连接测试可能只验证了服务地址或模型列表。聊天还依赖模型权限、余额、接口类型及请求参数，需结合具体错误排查。
提示模型不存在
检查模型 ID 的拼写、令牌模型限制，以及客户端是否仍在使用内置的默认模型名称。
网页客户端提示跨域错误
浏览器客户端会受到跨域策略影响。优先使用本站支持的接入方式，或查看客户端提供的服务端代理方案。不要通过关闭浏览器安全机制解决问题，也不要将令牌发送到不可信的公共代理。
一直等待或回复中途停止
检查网络、代理和客户端超时设置；确认是否开启流式输出，并查看错误排查。