API Reference
Models
List available models and understand model routing
List Models
Retrieve a list of all models available through Router9.
GET /v1/modelsExample 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:
- The model ID is matched against configured routes using prefix matching
- Routes are sorted by priority (highest first)
- 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
| Provider | Example Models |
|---|---|
| OpenAI | gpt-4o, gpt-4o-mini |
| Anthropic | claude-3-sonnet, claude-3-opus |
gemini-2.0-flash | |
| OpenRouter | All 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
| Plan | Models Available |
|---|---|
| Free | Free-tier OpenRouter models |
| Assistant | All models (GPT-4o, Claude, Gemini, etc.) |
| Engineer | All models with low-latency routing |