OpenRouter Plugin

​

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

​

Embedding Models

• text-embedding-3-large (OpenAI via OpenRouter)
• qwen3-embedding (Qwen)
• gemini-embedding (Google)
• mistral-embed (Mistral)

OPENROUTER_EMBEDDING_MODEL=openai/text-embedding-3-large

​

Model Configuration

• SMALL_MODEL: Fast, cost-effective responses
• LARGE_MODEL: Complex reasoning, best quality
• IMAGE_MODEL: Multimodal capabilities

​

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

1. Pay-per-token - No monthly fees
2. Price transparency - See costs per model
3. Credits system - Pre-pay for usage

​

External Resources

• Plugin Source
• OpenRouter Documentation
• Model List & Pricing