Skip to content
OdiRouter Docs
Home

Troubleshooting Integrations

Most integration issues come from an incorrect Base URL, missing API key, unavailable model ID, or a tool not loading the latest configuration.

Common errors

Section titled “Common errors”
SymptomLikely causeFix
401 or invalid API keyMissing or incorrect keyCreate a new API key and send it as Authorization: Bearer YOUR_API_KEY
404 model not foundWrong model IDQuery GET https://www.odirouter.ai/v1/models and copy the exact model ID
Tool appends paths twiceFull endpoint pasted into a Base URL fieldUse the Base URL field for https://www.odirouter.ai/v1
Tool calls /chat/completions/chat/completionsFull endpoint pasted into a Base URL fieldUse the Base URL field for https://www.odirouter.ai/v1
Streaming hangsClient cannot parse SSE or model does not streamDisable streaming or choose a streaming-capable model
Claude Code cannot connectEnvironment variables are not loadedSet ANTHROPIC_BASE_URL to https://www.odirouter.ai and restart claude

Verify outside the tool

Section titled “Verify outside the tool”

Run this command before debugging an IDE or workflow platform:

Окно терминала
curl -sS "https://www.odirouter.ai/v1/chat/completions" \
  -H "Authorization: Bearer ${ODIROUTER_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {
        "role": "user",
        "content": "Reply with: OdiRouter integration works"
      }
    ]
  }'

If the direct call works but the tool fails, the problem is in the tool’s provider configuration. If the direct call fails, fix the API key, model ID, or account balance first.

Base URL rules

Section titled “Base URL rules”