通用配置字段
大多数客户端需要配置 3 项：API Key、Base URL、Model。MonkeyAI 默认按 OpenAI 兼容格式接入，配置成本最低。
Provider / 类型: OpenAI Compatible / OpenAI 兼容
Base URL: https://monkeytheme.com/v1
API Key: sk-你的 API Key
推荐模型: gpt-4o-mini
如果客户端会自动补
/v1，你就改填 https://monkeytheme.com。最常见的 404，都是这里多写了一层 /v1。接入客户端前，建议先用 API 测试确认接口可用
先确认 key、余额、模型、路由都能通，再接入客户端。
curl https://monkeytheme.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的APIKey" \
-H "Content-Type: application/json" \
-d '{
"model":"gpt-4o-mini",
"messages":[{"role":"user","content":"Hello MonkeyAI"}]
}'
这条请求有正常回复，再配置客户端，说明你的 API 本身没问题。
Cherry Studio
- 打开 Cherry Studio。
- 进入 设置 → 模型服务商。
- 新增或选择 OpenAI Compatible / OpenAI 兼容。
- 填写下面两项。
API Key: sk-你的 API Key
Base URL: https://monkeytheme.com/v1
然后在模型列表里手动添加这些常用模型：
gpt-4o-mini
gpt-4o
gpt-4o
claude-sonnet-4-20250514
claude-3-opus-latest
deepseek-chat
gpt-image-2
Cherry Studio 某些版本会自动处理
/v1。如果你填完后提示 404，就改填 https://monkeytheme.com。Chatbox
在 Settings 里把模型服务改成 OpenAI Compatible，然后填写：
API Host / Base URL: https://monkeytheme.com/v1
API Key: sk-你的 API Key
Model: gpt-4o-mini
LobeChat
进入 设置 → Model Provider，选择 OpenAI 兼容服务商，填写：
Base URL: https://monkeytheme.com/v1
API Key: sk-你的 API Key
NextChat / ChatGPT-Next-Web
自部署环境常见写法：
OPENAI_API_KEY=sk-你的APIKey
BASE_URL=https://monkeytheme.com
如果当前客户端版本不会自动补全 /v1，请使用：
BASE_URL=https://monkeytheme.com/v1
Open WebUI
在 OpenAI 兼容提供商里填写：
Base URL: https://monkeytheme.com/v1
API Key: sk-你的 API Key
保存后同步模型，或者手动添加模型 ID。
常见排错
1）404 / 路径错了
最常见原因是地址被重复拼接成 /v1/v1。请先确认客户端是否会自动补全 /v1，避免路径重复。
2）401 / API key invalid
检查 key 前后有没有空格、换行，有没有漏掉 sk-。
3）model not found
请勿自行猜测模型名，直接查询模型列表获取正确名称：
curl https://monkeytheme.com/v1/models \
-H "Authorization: Bearer sk-你的APIKey"
4）Claude 模型能否用于 OpenAI 兼容客户端？
可以在 OpenAI 兼容客户端中使用后台可见的 Claude 模型名。请以当前账号的模型列表为准，不要自行改写模型 ID。
建议一个客户端一个 API Key。后续查看用量、停用、轮换和排障会更清晰。