OpenAI 格式 API 通用接入说明（含 Cherry Studio 配置教程）
关键词：OpenAI API、Base_URL 配置、API Key、模型接入、Cherry Studio 教程、AI 客户端配置
最近在折腾一些 AI 应用和本地客户端时，发现很多同学在API 接入阶段就卡住了：
- 不清楚 Base_URL 怎么填
- 不知道模型名从哪里来
- 不确定手里的工具到底支不支持
其实现在情况已经简单很多了。
账号注册与控制台入口（用于获取 Key）
👉 注册地址（示例）：
🔗 https://www.aiping.cn/#?invitation_code=MBSOW1
注册完成后，在控制台中创建并复制 API Key，后续所有客户端都会用到。
一、关于 API 接入的几个关键点
该栏目中列出的只是部分常用的应用集成教程，并不意味着只能使用这些应用。
✅ 核心结论先说明
API 已完全兼容 OpenAI 接口格式
也就是说——
👉凡是支持 OpenAI 的应用或开发工具，基本都可以直接使用
如果你正在使用其他 AI 客户端或开发工具，但不清楚如何配置，一般只需要下面这三个参数。
二、调用 API 只需要配置的 3 个参数
在绝大多数应用或开发工具中，只需要填写：
| 常见名称 | 可能的别名 |
|---|---|
| Base_URL | API 地址、接口地址 |
| Api_Key | 密钥、令牌 |
| 模型名 | Model、Model Name |
⚠️ 不同软件叫法可能不一样，但本质是同一组参数。
三、Base_URL 地址说明
https://aiping.cn/api/v1/常见情况说明：
- 完整 OpenAI 格式调用地址：
https://aiping.cn/api/v1/ - 部分应用已经自动补全
/v1
👉 这种情况下，只需要填主域名即可 - 如果工具没有明确提示如何填写 Base_URL
👉 可以依次尝试完整地址和主地址
五、Cherry Studio 配置教程（新手友好）
Cherry Studio 是一个开源 AI 桌面客户端，支持：
- 普通对话
- 联网搜索
- 知识库
- 多模型切换
非常适合作为第一次接触 API 的工具。
📦 客户端下载地址：
https://pan.quark.cn/s/f11b18b2a9a4
1️⃣ 打开设置并添加模型服务
进入客户端后：
左下角（或右上角）⚙️ 设置
→ 模型服务
→ 点击底部【添加】
2️⃣ 配置 API 地址和密钥
在配置页面中填写：
- API 地址（Base_URL）
- API Key
3️⃣ 添加模型
点击「添加模型」后，会弹出模型列表窗口。
在列表中可以看到所有可用模型：
👉 点击模型名称右侧的➕即可添加
4️⃣ 选择模型并开始使用
回到对话页面：
- 点击顶部模型名称
- 自由切换刚刚添加的模型
- 正常开始对话
六、一些实际使用建议
如果你是第一次接触 API 服务
- 建议先用Cherry Studio这种现成客户端熟悉流程
后续再接入：
- Web 项目
- Node / Python
- 各类第三方 AI 工具
配置方式基本一致
七、小结
简单总结一下整个流程：
注册账号 → 获取 API Key → 填 Base_URL → 选模型 → 开始使用
只要一个工具支持OpenAI API 格式，接入成本基本都在5 分钟以内。
如果后续你用的是其他 AI 客户端或开发工具，但配置项对不上，可以按这篇文章的思路对照，一般都能顺利接好。
