先用最小请求测试 API，不要一上来就反复修改 Hermes、Codex、Cline 或其他客户端。根据返回状态，只改一个变量：API Key、Base URL、端点路径或模型名。
先在终端设置自己的 MonkeyAI API Key，再请求模型列表：
export MONKEYAI_API_KEY='替换成你的真实 Key' curl -i https://monkeytheme.com/v1/models \ -H "Authorization: Bearer $MONKEYAI_API_KEY"
API_KEY_REQUIRED，这是鉴权保护正常，不是服务宕机。不要在聊天、工单或公开截图中展示完整 Key。测试后如使用共享电脑，可执行 unset MONKEYAI_API_KEY 清除当前 Shell 变量。
| 返回 | 先检查什么 | 处理方法 |
|---|---|---|
| 401 / invalid token | Authorization 请求头、Key 是否完整、是否失效、是否来自其他系统 | 重新复制 MonkeyAI 后台的 Key；格式必须是 Bearer + 空格 + Key |
| 404 | Base URL 或端点路径 | API Base URL 使用 https://monkeytheme.com/v1；模型列表路径是 /v1/models |
| model not found | 模型名是否在当前账号可见列表中 | 从实时价目表或后台模型列表复制模型名，不要凭旧教程猜模型名 |
| 504 / timeout | 请求大小、上游状态和发生时间 | 先缩短请求重试；仍失败时记录时间、模型、端点和状态码后联系支持 |
把 <CURRENT_MODEL> 替换为当前实时价目表或后台中可见的模型名：
curl https://monkeytheme.com/v1/chat/completions \
-H "Authorization: Bearer $MONKEYAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"<CURRENT_MODEL>","messages":[{"role":"user","content":"只回复 OK"}],"max_tokens":16}'
只有直接 API 请求通过后，再把同一 Base URL、Key 和模型名填入客户端。这样可以区分“API 本身失败”和“客户端配置错误”。
请提供发生时间、模型名、端点路径、HTTP 状态和已脱敏的请求。不要发送完整 API Key。
/v1/models 返回 401，Key 末尾为 abcd。带 Authorization 请求头调用 GET /v1/models。它可以同时检查 Base URL 和 API Key，而且不会发起对话请求。
通常不是。401 表示请求没有通过鉴权，应先检查请求头、Key 是否完整、是否已失效，以及它是否来自 MonkeyAI 当前系统。
通常不是。404 更常见于 URL 或端点路径错误，例如把官网地址直接当成 API Base URL，或遗漏 /v1。
不可以。只提供时间、端点、HTTP 状态、模型名和 Key 末尾少量字符；截图与日志中必须遮住完整 Key。