MetisRouter Troubleshooting Guides
Fix common OpenAI-compatible API setup, model ID, streaming, timeout, and billing errors before production traffic.
Last verified: 2026-06-05
Set the API base URL to https://api.metisrouter.com/v1, paste a MetisRouter API key, choose a published chat model ID, then send a short test prompt.
TroubleshootingFix Cline OpenAI-Compatible Provider ErrorsChoose OpenAI Compatible, set MetisRouter as the base URL, use Bearer API key authentication, and copy the exact model ID from the catalog.
TroubleshootingFix n8n OpenAI-Compatible API ErrorsUse an HTTP Request or OpenAI Chat Model node with Bearer auth, set max_tokens, and log the request id for support.
TroubleshootingOpen WebUI Model List Not Loading: API Base URL FixUse https://api.metisrouter.com/v1 as the API base URL, confirm the API key can call /v1/models, then refresh the provider model list.
TroubleshootingClaude Code Custom Base URL and API Routing GuideUse Anthropic Direct only for models tagged Anthropic Direct; otherwise use an OpenAI-compatible coding model through the documented path.
TroubleshootingCline Model Not Found: Model ID and Endpoint FixesOpen /models, copy the exact API model ID from the model drawer, and make sure the model supports the OpenAI-compatible text endpoint.
TroubleshootingOpenAI-Compatible Streaming Not WorkingSet stream=true only for text endpoints that support streaming, keep max_tokens bounded, and verify the request in Usage Logs.
TroubleshootingTool Calling with OpenAI-Compatible APIsChoose a model tagged for tool calling or structured output, pass tools in the OpenAI-compatible request body, and keep tool output short enough for context.
TroubleshootingFix 524 Timeouts in Long-Running AI API RequestsUse smaller bounded requests, model-specific async task patterns for long generation jobs, and retry only after checking Usage Logs.
TroubleshootingWhy Low-Balance Requests Need max_tokensKeep at least 5 USD available balance and set max_tokens, max_completion_tokens, or max_output_tokens before sending low-balance requests.
TroubleshootingCursor OpenAI API Key Not Working with Custom ProvidersCreate a MetisRouter API key, paste it into Cursor's OpenAI-compatible provider settings, keep the base URL on /v1, and test with a published chat model ID.
TroubleshootingCodex API Key Not Found: MetisRouter Setup ChecklistStore the MetisRouter key in the environment variable expected by the client, set the OpenAI-compatible base URL, and run one bounded test request.
TroubleshootingCoding Agent 524 Timeout: Base URL, Streaming, and max_tokens FixUse streaming when supported, bound output with max_tokens or max_output_tokens, split large repository tasks, and inspect Usage Logs before retrying.
TroubleshootingCline Qwen Coder Setup with MetisRouterChoose OpenAI Compatible in Cline, set the MetisRouter base URL, paste the API key, copy an exact Qwen coding model ID from /models, and verify Usage Logs.
Start from the visible error
Use these pages when a tool rejects the base URL, cannot find a model, fails streaming, times out, or refuses a request because the account balance or output limit is not bounded.
- Copy the exact model ID from the model catalog.
- Use Usage Logs to separate platform errors from upstream provider errors.
- Keep request IDs when contacting support.
FAQ
Where should I start?
Start with the page that matches the tool or visible error message, then verify the first fixed request in Usage Logs.
Are these pages indexable?
Yes. Each guide has its own canonical URL, metadata, structured data, and sitemap entry.