悠然 AI 简介
悠然 AI 是面向开发者的 AI 模型接入与用量管理服务。你只需要维护一套 API 地址和个人 API Key，就可以在 Claude Code、Codex、Cursor 以及其他兼容客户端中调用当前可用的 GPT 模型。
它解决什么问题
Section titled “它解决什么问题”- 统一接入：所有客户端使用
https://youran-ai.du-fu.com/api，不需要为每个工具寻找不同的服务地址。 - 个人鉴权：每位用户使用自己的 API Key，请求、用量与权限分别归属到个人账户。
- 动态模型：通过
/api/models获取当前可用模型，不依赖文档中可能过期的固定模型名称。 - 用量可见：在控制台查看请求记录、输入与输出 Token，以及缓存输入和缓存写入用量。
- 使用方式管理：根据账户状态使用按量计费或已生效的席位订阅。
当前支持的接口
Section titled “当前支持的接口”| 协议 | 主要接口 | 典型客户端 |
|---|---|---|
| OpenAI Models | GET /api/models |
所有客户端 |
| OpenAI Responses | POST /api/responses |
Codex |
| OpenAI Chat Completions | POST /api/chat/completions |
Cherry Studio、Chatbox 等 |
| Anthropic Messages 兼容层 | POST /api/v1/messages |
Claude Code |
| 用途 | 地址 |
|---|---|
| 落地页 | https://youran-ai.du-fu.com/ |
| 控制台 | https://youran-ai.du-fu.com/admin/ |
| 文档站 | https://youran-ai.du-fu.com/doc/ |
| API | https://youran-ai.du-fu.com/api |
当前使用边界
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 只应保存在用户级环境变量、操作系统凭据存储或个人配置中，禁止写入项目仓库。