Quick Start

1. Create an Account

Sign up at www.router9.com/login using your email address. You'll receive a one-time verification code to complete registration.

New accounts require admin approval before you can access the dashboard. You'll be redirected automatically once approved.

2. Create a Token Plan

Once logged in, go to the dashboard and click New Token Plan. Give your plan a name and optional description.

Your Token Plan has its own API keys, usage quotas, and audit logs.

3. Get Your API Key

After creating a plan, you'll be taken to the API Keys tab. Your key is displayed once — copy it and store it securely.

API keys use the format sk-r9k-<key>.

4. Make Your First Request

Router9 is OpenAI-compatible. Set your base URL and API key, then use any OpenAI-compatible client:

curl https://api.router9.com/v1/chat/completions \
  -H "Authorization: Bearer sk-r9k-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      { "role": "user", "content": "Hello, Router9!" }
    ]
  }'

5. Use with the OpenAI SDK

from openai import OpenAI

client = OpenAI(
    base_url="https://api.router9.com/v1",
    api_key="sk-r9k-your-key-here",
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.router9.com/v1",
  apiKey: "sk-r9k-your-key-here",
});

const response = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "Hello!" }],
});

console.log(response.choices[0].message.content);

6. Configure Your Environment

For most AI tools, just set two environment variables:

OPENAI_BASE_URL=https://api.router9.com/v1
OPENAI_API_KEY=sk-r9k-your-key-here

This works with Claude Code, OpenCode, Cursor, LangChain, Vercel AI SDK, and any other OpenAI-compatible harness.

Next Steps

Authentication — Learn about API key management
Chat Completions — Full API reference
Plans & Billing — Understand pricing tiers