图文使用指南

跟着下面的步骤操作，5 分钟就能完成第一次调用。

1. 登录管理页面

打开卡皮巴拉的管理网址，输入你的登录账号/密码。

TIP

如果你还不知道登录地址或账号，请联系给你提供服务的卖家或客服。

2. 进入密钥管理

登录成功后，在左侧菜单或顶部导航找到「密钥管理」（也可能叫「API Key 管理」），点进去后再点「创建密钥」按钮。

3. 创建你的访问密钥

在弹出的表单里：

• 密钥名称：随便起一个方便你自己识别的名字，比如"Cherry Studio用"、"测试用"
• 其他选项保持默认即可（如果有额度、有效期等设置，按需调整）

填完点确认。

重要：立即复制你的 Key！

密钥创建成功后，页面会显示一串 sk-xxxxxxxx... 开头的字符串。这是你唯一一次能看到完整 Key 的机会，请立刻复制并保存到一个安全的地方（比如笔记软件、密码管理器）。

如果忘记保存，只能删除后重新创建。

4. 把 Key 填到你的 AI 工具里

打开你想使用的 AI 工具（Cherry Studio、Chatbox、NextChat 等），找到 「设置」→「模型服务」→「OpenAI」 或类似的入口，按下表填写：

设置项	填写内容	说明
API 地址 / Base URL	https://api.example.com/v1	卡皮巴拉的服务地址
API Key / 密钥	上一步复制的 Key	以 sk- 开头那一串
模型 / Model	选一个，比如 gpt-4o-mini	看你想用哪个模型

容易出错的地方

• API 地址不要在末尾多加或少加 /v1，照着上面表格里的写就对了
• API Key 复制时别带上多余的空格
• 模型名称要写完整，大小写也要对

5. 验证是否能用

填完保存后，在 AI 工具里发一条简单的消息，比如「你好」。

• ✅ 能正常回复 → 配置成功，开始使用吧
• ❌ 报错或没反应 → 看 常见问题排查

进阶用法

• 想在多个 AI 工具间快速切换配置 → 用 CC-Switch 桌面工具
• 想了解每个客户端的具体配置 → 看 客户端接入