Tool 01 / Agent API Tester

AI Agent API Tester:先验证接口,再去配 Hermes、Codex、Cline。

这个工具帮你先做两件事:检查 Base URL、API Key、模型名 是否真实可用;再给出下一步建议,告诉你这组配置更适合 Hermes / OpenClaw / Cline / Roo Code / Cherry Studio 哪类客户端。

建议顺序:先跑 /models,确认鉴权没问题;再跑一次简短 /chat/completions,确认模型名和响应链路也通。这样最容易提前发现 401、404、model not found、/v1/v1 写重、或者 Key 复制不完整。
1先测鉴权
2再测模型
3输出建议
4复制配置
Step 1

输入测试参数

默认就是 MonkeyAI 客户入口。不要手滑写成 /v1/v1。
页面不会存储你的 Key;仅在当前浏览器里发请求。
这里填你后台里真实可见的模型名。
结果会显示在这里。成功时会告诉你下一步该用哪个客户端、配什么位置;失败时会给出最常见的修法。
Step 2

通过测试后,下一步怎么做

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。
Troubleshooting

最常见 5 个失败原因

  1. 401 unauthorized:Key 复制不完整、前后多了空格,或填错账户的 Key。
  2. 404 / 路径错:Base URL 写成了 https://monkeytheme.com 但客户端又自动补一次 /v1,或者你手动写成了 /v1/v1。
  3. model not found:模型名不是后台实际在售名称,先去价目表或 /v1/models 查真实名称。
  4. CORS / 浏览器拦截:如果你测试的是别家的跨域地址,浏览器可能拦截;这时建议直接用 curl 或 Python 验证。
  5. Claude Code 跑不通:大概率是协议层不匹配,不是 Key 本身坏了。