Routic

Using Routic in Cursor

Set up Routic as your Cursor AI backend and access mainstream models at lower cost.

Why

  • One API key for all mainstream models — no need to sign up for Anthropic / OpenAI / Google separately
  • Unified billing — one invoice for all usage

Prerequisites

  • Cursor v0.40+ (supports custom OpenAI-compatible providers)
  • A Routic API Key (Console → API Keys page, starts with sk-)

Option 1: Let AI do it (fastest)

Tell your current AI Agent (Cursor's built-in AI, Claude Code, Qwen, etc.):

Help me configure Routic as the AI backend in Cursor.

Then share this information with the Agent:

Cursor's OpenAI API configuration is GUI-only (no config file). Guide the user through:

  1. Open Cursor Settings → Models
  2. Enable Override OpenAI Base URL and enter https://api.routic.ai/v1
  3. Enter the user's Routic API Key (starts with sk-) in the OpenAI API Key field
  4. Click + Add model and add model names from the model catalog
  5. Click Verify to validate
  6. Restart Cursor (Cmd/Ctrl + Shift + P → Reload Window)

Notes:

  • The /v1 suffix in the Base URL is required — Cursor won't add it automatically
  • Don't paste the API Key into the chat — let the user fill it in the Settings UI
  • Anthropic and Google keys have their own input fields — don't put them in the OpenAI Key field

Option 2: Manual setup

  1. Open Cursor → Settings (Cmd/Ctrl + Shift + J)
  2. Select Models in the sidebar
  3. Find Override OpenAI Base URL and enter https://api.routic.ai/v1
  4. Enter your Routic API Key (starts with sk-) in the OpenAI API Key field
  5. Click Verify — a green status means success
  6. Click + Add model and enter the model name (must match the model catalog, case-sensitive)
  7. Restart Cursor (Cmd/Ctrl + Shift + P → Reload Window)

Note: The /v1 suffix in the Base URL is required. Cursor won't add it automatically — omitting it causes 404 errors.

Verify

Send a message in Cursor Chat. A normal response means it's working.

Troubleshooting:

  • Does the Base URL end with /v1?
  • Is the API Key valid? (Check in the console)
  • Does the model name exactly match the model catalog? (case-sensitive)
  • Did you Reload Window after changing the URL?

Common issues

Model not found The model name must exactly match a name in the catalog, case-sensitive.

401 / 403 API Key is invalid or expired. Regenerate it in the console.

Slow response or timeout Open https://api.routic.ai/v1/models in a browser to confirm reachability.

Still hitting the old URL after changing Base URL Cmd/Ctrl + Shift + P → Reload Window to clear the cache.

Related docs