Router9
Documentation
API Reference

Models

List available models and understand model routing

List Models

Retrieve a list of all models available through Router9.

GET /v1/models

Example Request

curl https://api.router9.com/v1/models \
  -H "Authorization: Bearer sk-r9k-your-key"

Response

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "owned_by": "openai"
    },
    {
      "id": "gpt-4o-mini",
      "object": "model",
      "owned_by": "openai"
    },
    {
      "id": "claude-3-sonnet",
      "object": "model",
      "owned_by": "anthropic"
    },
    {
      "id": "claude-3-opus",
      "object": "model",
      "owned_by": "anthropic"
    },
    {
      "id": "gemini-2.0-flash",
      "object": "model",
      "owned_by": "google"
    },
    {
      "id": "auto",
      "object": "model",
      "owned_by": "router9"
    }
  ]
}

Model Routing

Router9 uses a dynamic routing system. When you request a model:

  1. The model ID is matched against configured routes using prefix matching
  2. Routes are sorted by priority (highest first)
  3. The request is forwarded to the matched upstream provider

The auto Model

Setting model to "auto" lets Router9 automatically select a model. This is useful when you want the best available model without hardcoding a specific one.

Available Providers

ProviderExample Models
OpenAIgpt-4o, gpt-4o-mini
Anthropicclaude-3-sonnet, claude-3-opus
Googlegemini-2.0-flash
OpenRouterAll models available via OpenRouter

The exact list of available models depends on your server's configuration. Use the List Models endpoint to see what's currently available.

Model Access by Plan

PlanModels Available
FreeFree-tier OpenRouter models
AssistantAll models (GPT-4o, Claude, Gemini, etc.)
EngineerAll models with low-latency routing

On this page