其他兼容客户端

悠然 AI 可以接入大量支持 OpenAI 协议的第三方客户端，但“OpenAI 兼容”并不等于所有 OpenAI 功能都可用。客户端还需要允许自定义 Base URL、API Key 和模型 ID，并且只调用悠然 AI 已开放的端点。

给新手的话

如果你没有编程经验或 AI 使用经验，建议先使用内置聊天，无需安装软件和创建 API Key。只有在已经习惯某个第三方客户端，或确实需要其本地功能时，再按本页说明接入。Cherry Studio 和 Chatbox 都有中文界面；开始配置前，请先在控制台创建 API Key，并到模型怎么选挑选模型 ID。

结论

只要客户端能把 https://youran-ai.du-fu.com/v1 作为 OpenAI Base URL，使用 Authorization: Bearer <YOURAN_API_KEY> 鉴权，并通过 Chat Completions 或 Responses 发起请求，通常就可以接入。

按软件查看分步指南

软件	适合谁
Cherry Studio	中文界面、第一次接触 AI 客户端的新手
Chatbox	喜欢简洁界面的国内用户
Open WebUI	自己部署网页版聊天界面的团队
Aider	习惯在终端里写代码的开发者

Cursor 已按操作系统拆分为独立工具页面：Windows：Cursor、macOS：Cursor。

兼容条件

接入前请确认客户端同时满足以下条件：

条件	悠然 AI 要求
Base URL	可以自定义为 https://youran-ai.du-fu.com/v1
API Key	使用标准 Authorization: Bearer 请求头
模型列表	请求 GET {Base URL}/models，或允许手工填写模型 ID
对话协议	支持 OpenAI Chat Completions，或 OpenAI Responses
流式输出	能处理标准 SSE 流式响应
模型名称	允许使用 /v1/models 返回的实际模型 ID

悠然 AI 当前公开的 OpenAI 兼容端点包括：

方法	最终请求地址
GET	https://youran-ai.du-fu.com/v1/models
POST	https://youran-ai.du-fu.com/v1/chat/completions
POST	https://youran-ai.du-fu.com/v1/responses

使用标准 /v1 路径

普通 OpenAI 兼容客户端的 Base URL 以 /v1 结尾。像 Cherry Studio 这样会自动追加 /v1 的客户端只需填写域名根地址。

不兼容或仅部分兼容的情况

以下客户端不能直接保证可用：

• Base URL 固定为 https://api.openai.com/v1，不允许修改域名。
• 只能使用 OpenAI 官方 OAuth 登录，不接受独立 API Key。
• 模型被固定在客户端内置白名单中，无法填写 /v1/models 返回的模型 ID。
• 必须调用 Embeddings、Images、Audio、Files、Assistants、Batches 或其他未开放的 OpenAI 端点。
• 依赖 OpenAI 官方专属能力，而不是标准 Chat Completions 或 Responses 请求格式。

遇到不确定的客户端时，先查找设置中的 “OpenAI Compatible”“Custom OpenAI”“API Base” 或 “Endpoint” 选项，再对照本页的三个公开端点。

接入失败时检查

1. 普通 OpenAI 客户端的 Base URL 是否为 https://youran-ai.du-fu.com/v1；Cherry Studio 是否只填写域名根地址。
2. 模型 ID 是否来自当前 /v1/models 响应。
3. 客户端实际请求的是 /chat/completions、/responses 还是未支持的其他路径。
4. 请求头是否为 Authorization: Bearer <YOURAN_API_KEY>。
5. API Key 是否仍然有效，所属用户是否具有可用额度。

仍然无法连接时，请记录客户端实际请求路径与 HTTP 状态码，再前往故障排查。