Skip to main content

​
Features

  • Multiple providers - Access 50+ models from various providers
  • Automatic failover - Route to available providers
  • Cost optimization - Choose models by price/performance
  • Single API key - One key for all providers

​
Installation

elizaos plugins add @elizaos/plugin-openrouter

​
Configuration

​
Environment Variables

# Required
OPENROUTER_API_KEY=sk-or-...

# Optional model configuration
# You can use any model available on OpenRouter
OPENROUTER_SMALL_MODEL=google/gemini-2.0-flash-001           # Default: google/gemini-2.0-flash-001
OPENROUTER_LARGE_MODEL=google/gemini-2.5-flash-preview-05-20 # Default: google/gemini-2.5-flash-preview-05-20
OPENROUTER_IMAGE_MODEL=anthropic/claude-3-5-sonnet           # For vision tasks

# Examples of other available models:
# OPENROUTER_SMALL_MODEL=anthropic/claude-3-haiku
# OPENROUTER_LARGE_MODEL=anthropic/claude-3-opus
# OPENROUTER_LARGE_MODEL=openai/gpt-4o
# OPENROUTER_SMALL_MODEL=meta-llama/llama-3.1-8b-instruct:free

​
Character Configuration

{
  "name": "MyAgent",
  "plugins": [
    "@elizaos/plugin-openrouter"
  ]
}

​
Supported Operations

OperationSupportNotes
TEXT_GENERATION✅All available models
EMBEDDING✅Multiple embedding models available
OBJECT_GENERATION✅Model dependent

​
Embedding Models

OpenRouter now provides embedding endpoints with multiple models:
  • text-embedding-3-large (OpenAI via OpenRouter)
  • qwen3-embedding (Qwen)
  • gemini-embedding (Google)
  • mistral-embed (Mistral)
Configure embedding model: 
OPENROUTER_EMBEDDING_MODEL=openai/text-embedding-3-large

​
Model Configuration

The plugin uses model tiers:
  • SMALL_MODEL: Fast, cost-effective responses
  • LARGE_MODEL: Complex reasoning, best quality
  • IMAGE_MODEL: Multimodal capabilities
OpenRouter provides access to 50+ models from various providers. You can use:

​
Premium Models

  • Any Anthropic Claude model (Opus, Sonnet, Haiku)
  • Any OpenAI GPT model (GPT-4o, GPT-4, GPT-3.5)
  • Google Gemini models (Pro, Flash, etc.)
  • Cohere Command models

​
Open Models

  • Meta Llama models (3.1, 3.2, 3.3)
  • Mistral/Mixtral models
  • Many models with :free suffix for testing

​
Pricing Strategy

OpenRouter charges a small markup (usually ~10%) on top of provider prices:
  1. Pay-per-token - No monthly fees
  2. Price transparency - See costs per model
  3. Credits system - Pre-pay for usage

​
External Resources