输入测试参数
默认就是 MonkeyAI 客户入口。不要手滑写成
/v1/v1。页面不会存储你的 Key;仅在当前浏览器里发请求。
这里填你后台里真实可见的模型名。
结果会显示在这里。成功时会告诉你下一步该用哪个客户端、配什么位置;失败时会给出最常见的修法。
通过测试后,下一步怎么做
Hermes / OpenClaw
优先按 Agent 接入中心 的自定义 OpenAI-compatible 方案配置。改 Hermes model/provider 之前,先做直连 API 验证,再切换活跃配置并重启 gateway。
Cline / Roo Code / Cherry Studio
这类客户端最适合直接接 OpenAI-compatible。Base URL 填
https://monkeytheme.com/v1,Key 填后台生成的 sk-...,模型填真实模型名。Codex CLI
Codex 适合通过配置文件/环境变量接入已验证可用的 OpenAI 接口。先确认 CLI 当前版本与你的接入方案一致,再用配置生成器复制示例。
Claude Code
Claude Code 原生更偏 Anthropic Messages 协议。若你只是想用 Claude 模型,建议优先用 Cline / Roo Code 等 OpenAI-compatible 客户端来接 MonkeyAI。
最常见 5 个失败原因
- 401 unauthorized:Key 复制不完整、前后多了空格,或填错账户的 Key。
- 404 / 路径错:Base URL 写成了
https://monkeytheme.com但客户端又自动补一次/v1,或者你手动写成了/v1/v1。 - model not found:模型名不是后台实际在售名称,先去价目表或
/v1/models查真实名称。 - CORS / 浏览器拦截:如果你测试的是别家的跨域地址,浏览器可能拦截;这时建议直接用 curl 或 Python 验证。
- Claude Code 跑不通:大概率是协议层不匹配,不是 Key 本身坏了。