Most API setup failures are easier to debug before a client is involved. Test the endpoint directly, read the error type, then change one variable at a time: key, Base URL, endpoint path or model name.
curl https://monkeytheme.com/v1/models \ -H "Authorization: Bearer YOUR_API_KEY"
Set MONKEYAI_API_KEY to your own key before running the command. If the request fails, fix the direct API problem before changing Hermes, Codex, Cline or any other client.
| Error | Likely cause | Fix |
|---|---|---|
| 401 / invalid token | Wrong, expired or cross-system API key | Create a fresh key in the MonkeyAI dashboard |
| 404 | Wrong endpoint or missing /v1 | Use https://monkeytheme.com/v1 |
| model not found | Model alias not enabled | Pick a visible model from pricing or dashboard |
| 504 / timeout | Upstream or routing issue | Retry with a smaller request or contact support with timestamp and model |
Send the timestamp, model name, endpoint path, HTTP status and a redacted request. Never send the full API key in chat or public screenshots.
GET /v1/models with your Authorization header. It verifies the Base URL and API key without spending tokens on a chat request.
Usually no. It normally means the key is missing, invalid, expired or belongs to another system.
No. 404 usually points to a wrong URL or endpoint path, especially missing /v1.
No. Share only the last few characters, timestamp, HTTP status and model name.
Run /v1/models first. It tells you whether the key and endpoint are valid before you change a client.
Open API referenceConnect Hermes Agent, Codex CLI, Cline, Roo Code, Cherry Studio or your own app.
Open agent guidesReview visible models and prices before using the API in production workloads.
Open pricing