客户端接入
通用客户端
Chatbox、Cherry Studio 与自定义服务商
自定义服务商
Chatbox、Cherry Studio、WorkBuddy 等客户端可用的功能取决于应用版本和协议。添加自定义服务商时，填写协议、基础地址、Key 和完整模型 ID，并核对客户端是否改写了模型名。
| 协议 | 通常填写的基础地址 | 结果接口 |
|---|---|---|
| OpenAI Compatible | https://www.yunqiai.chat/v1 | 客户端需支持目标 Chat 或 Responses 接口 |
| Anthropic 原生 | https://www.yunqiai.chat | /v1/messages |
| Gemini 原生 | https://www.yunqiai.chat，依客户端拼接规则 | /v1beta/models/{model}:generateContent |
各应用对“API 地址”的定义不同，可能要求完整端点，也可能只要求根地址。保存后检查最终 URL，常见错误包括 /v1/v1、/responses/chat/completions 和缺少版本路径。
文件与图片
上传附件前，确认模型支持相应格式，且客户端会按协议发送图片、PDF 或媒体内容块。仅将路径或 Base64 作为普通文字发送，无法完成文件上传。
部分聊天客户端不支持 Images multipart 编辑、MJ 任务轮询或 Realtime 音频事件。此时需使用文档中的接口程序，或在应用中实现相应协议；在模型列表中添加名称并不会补齐这些功能。
保存后的检查
确认服务商已启用，模型 ID、Key、代理和证书设置正确。然后分别检查文本请求、流式输出，以及业务需要的文件或工具调用。测速仅供连接排查使用。