Skip to main content
OpenRouter is a unified API that provides access to multiple LLM providers through a single OpenAI-compatible interface. Switch between Claude, Gemini, GPT, and more without changing your code.
Vision Agents requires a Stream account for real-time transport. Most providers offer free tiers to get started.

Installation

uv add vision-agents[openrouter]

Quick Start

from vision_agents.core import User, Agent
from vision_agents.plugins import openrouter, getstream, elevenlabs, deepgram

agent = Agent(
    edge=getstream.Edge(),
    agent_user=User(name="Assistant", id="agent"),
    instructions="You are a helpful assistant.",
    llm=openrouter.LLM(model="anthropic/claude-sonnet-4"),
    tts=elevenlabs.TTS(),
    stt=deepgram.STT(),
)
Set OPENROUTER_API_KEY in your environment or pass api_key directly.

Parameters

NameTypeDefaultDescription
modelstr"openrouter/andromeda-alpha"Model identifier (see available models)
api_keystrNoneAPI key (defaults to OPENROUTER_API_KEY env var)
base_urlstr"https://openrouter.ai/api/v1"API base URL

Available Models

ProviderModel ID
Anthropicanthropic/claude-sonnet-4, anthropic/claude-opus-4
Googlegoogle/gemini-2.5-flash, google/gemini-2.5-pro
OpenAIopenai/gpt-4o, openai/gpt-4o-mini
See OpenRouter Models for the full list.

Next Steps