OpenRouter Models and Features

Getting the Models List

To get the full list of available models with pricing and capabilities:

curl https://openrouter.ai/api/v1/models -H "Authorization: Bearer $OPENROUTER_API_KEY"

The response includes:

Model ID and name
Pricing (prompt/completion tokens)
Context length
Supported parameters
Architecture details

Note: This list can be very large (thousands of tokens). The models are sorted by creation date (newest first), which serves as a decent proxy for quality given AI's rapid pace.

Tip: Save the full JSON to a file and use grep/jq to filter by price, context length, or capabilities rather than loading everything into context.

Model Selection Shortcuts

Speed Optimization: `:nitro`

Append :nitro to any model ID to use the fastest available provider for that model.

Example: anthropic/claude-3.5-sonnet:nitro

Web Search: `:online`

Append :online to any model ID to enable web search capabilities.

Example: openai/gpt-4o:online

Combining Modifiers

You can combine modifiers:

Example: anthropic/claude-3.5-sonnet:nitro:online

Common Model Format

OpenRouter uses the format provider/model-name:

anthropic/claude-3.5-sonnet
openai/gpt-4o
google/gemini-pro-1.5
meta-llama/llama-3.1-405b-instruct

Cost and Usage Tracking

The API returns usage data in the response JSON under the usage field:

{
  "usage": {
    "prompt_tokens": 14,
    "completion_tokens": 277,
    "total_tokens": 291
  }
}

Use the model's pricing information to calculate costs:

Cost = (prompt_tokens × prompt_price) + (completion_tokens × completion_price)

1.6 KiB Raw Permalink Blame History Unescape Escape