Creating a Routing Profile

A Routing Profile is a saved set of routing rules tied to its own API key. Any app using that key follows the profile’s rules automatically. No code changes needed after setup.

Step 1 - Go to Configure

Open Playground from the left sidebar. It opens on the Configure tab by default.

Step 2 - Pick a Template or Configure Manually

Start from a template - Chatbot, Research, Code Assistant, Customer Support, or Document Q&A - to prefill sensible defaults, or set every field yourself:

Field	What it does
Profile name	What you’ll call this profile
Model tier range	Click a tier to set the floor, click another to set the ceiling. Requests classify below the floor get bumped up; requests above the ceiling get capped
Required capabilities	Only route to models supporting the input types you select - vision, tools, file, audio, video
Cost cap per request	A hard USD ceiling. Routor only picks models whose estimated cost for the prompt is under this limit
Tool calling quality	Minimum function-calling accuracy required for tool/agent requests - “Any model” to “Best only”

Step 3 - Save and Get Your API Key

Click Save & get API key. Routor generates a dedicated key for this profile and shows it once - copy it immediately.

Step 4 - Use the Profile Key

Swap your existing key for the profile key. That is the only change.

const client = new OpenAI({
  apiKey:  "sk-routor-PROFILE_KEY_HERE",
  baseURL: "https://api.routor.io/v1",
});

const response = await client.chat.completions.create({
  model:    "auto",
  messages: [{ role: "user", content: prompt }],
});

Every request from this key now follows the profile rules.

Managing Profiles

From the Playground you can view all your profiles, see their settings, delete them, and test prompts against a specific profile to preview routing decisions before going live.

Profile Limits

Accounts are limited to 1 routing profile for now. Creating a second profile returns a 403 error:

{ "error": { "message": "Playground is limited to 1 routing profile for now." } }

Delete the existing profile from Playground → Manage Profiles if you need to create a different one.

Getting Started

Core Concepts

Dashboard

Playground

Providers

Guides

Creating a Routing Profile

Step 1 - Go to Configure

Step 2 - Pick a Template or Configure Manually

Step 3 - Save and Get Your API Key

Step 4 - Use the Profile Key

Managing Profiles

Profile Limits

​Step 1 - Go to Configure

​Step 2 - Pick a Template or Configure Manually

​Step 3 - Save and Get Your API Key

​Step 4 - Use the Profile Key

​Managing Profiles

​Profile Limits

Step 1 - Go to Configure

Step 2 - Pick a Template or Configure Manually

Step 3 - Save and Get Your API Key

Step 4 - Use the Profile Key

Managing Profiles

Profile Limits