悠然 AI 简介
悠然 AI 同时提供开箱即用的内置聊天和面向开发者的模型接入服务。普通用户可以直接在浏览器中与 AI 对话；需要编程或接入其他工具时，再使用统一的 API 地址和个人 API Key。
它解决什么问题
Section titled “它解决什么问题”- 标准路径：OpenAI 兼容客户端使用
https://youran-ai.du-fu.com/v1，Claude Code 使用域名根地址，不需要自定义非标准路径。 - 直接聊天：内置聊天只需登录普通用户账号，无需配置 API Key、Base URL 或模型 ID。
- 个人鉴权：每位用户使用自己的 API Key，请求、用量与权限分别归属到个人账户。
- 动态模型：通过
/v1/models获取当前可用模型，不依赖文档中可能过期的固定模型名称。 - 用量可见：在控制台查看请求记录、推理强度、输入与输出 Token，以及缓存输入、缓存写入和推理 Token 用量。
- 使用方式管理：根据账户状态使用按量计费或已生效的席位订阅。
当前支持的接口
Section titled “当前支持的接口”| 协议 | 主要接口 | 典型客户端 |
|---|---|---|
| OpenAI Models | GET /v1/models |
所有客户端 |
| OpenAI Responses | POST /v1/responses |
Codex |
| OpenAI Chat Completions | POST /v1/chat/completions |
Cherry Studio、Chatbox 等 |
| Anthropic Messages 兼容层 | POST /v1/messages |
Claude Code |
| 用途 | 地址 |
|---|---|
| 落地页 | https://youran-ai.du-fu.com/ |
| 控制台 | https://youran-ai.du-fu.com/admin/ |
| 内置聊天 | https://youran-ai.du-fu.com/chat/ |
| 文档站 | https://youran-ai.du-fu.com/doc/ |
| API | https://youran-ai.du-fu.com/v1 |
当前使用边界
Section titled “当前使用边界”- 悠然 AI 当前只提供模型列表中展示的 GPT 模型，不提供 Anthropic Claude 模型。
- Claude Code 在这里是客户端外壳，通过 Anthropic Messages 兼容层调用 GPT 模型。
- 第三方客户端需要支持自定义 Base URL、Bearer API Key 和模型 ID，并且只能调用悠然 AI 已开放的接口。
- Embeddings、Images、Audio、Files、Assistants 和 Batches 等未公开端点当前不可用。
- API Key 只应保存在用户级环境变量、操作系统凭据存储或个人配置中，禁止写入项目仓库。
- 公开 API 不保存提示词和响应正文；内置聊天会保存用户主动创建的会话正文、思考摘要和图片，具体见 内置聊天使用指南与隐私。