首页 / Cherry Studio / New API
Cherry Studio 接入 OpenAI 兼容 API：聊天客户端这样填
Cherry Studio 很适合桌面聊天和多模型管理。这里给一份 OpenAI 兼容网关填写方式，同时说明它和 Codex 团队编码入口的分工。
适合 Cherry Studio 的使用方式
Cherry Studio 更适合聊天、提示词、知识库和多模型切换。它可以接统一 API 网关，但如果你的目标是代码仓库修改、命令执行和工程任务，仍建议把 Codex 放在主入口。
推荐填写项
| 项目 | 填写建议 |
|---|---|
| 服务商类型 | OpenAI / OpenAI Compatible / 自定义 OpenAI |
| Base URL | https://izkl.top/v1 |
| API Key | 控制台发放的个人令牌 |
| 模型 | 添加网关已开放的模型名 |
排查顺序
- 先确认服务商开关已启用。
- 确认 API Key 没有复制空格、换行或过期。
- 确认 Base URL 带
/v1。 - 确认模型名在网关侧已经启用。
- 如果聊天能用但工具能力异常，先看客户端是否支持对应协议。
和 Codex 的关系
Cherry Studio 可以作为“聊天和模型测试入口”，Codex 更适合作为“代码代理入口”。两者可以共用同一个网关域名和个人令牌，但不要把两类使用场景混在一篇教程里，否则搜索流量和转化路径会变乱。
常见问题
Cherry Studio 的 API 地址要带 /v1 吗？
使用 OpenAI 兼容网关时通常要带 /v1，例如 https://izkl.top/v1。
Cherry Studio 可以和 Codex 共用令牌吗？
可以，但团队管理上更建议按成员或用途拆令牌，便于统计和限额。