mcp-run-python

# OpenRouter ## Install To use `OpenRouterModel`, you need to either install `pydantic-ai`, or install `pydantic-ai-slim` with the `openrouter` optional group: ```bash pip/uv-add "pydantic-ai-slim[openrouter]" ``` ## Configuration To use [OpenRouter](https://openrouter.ai), first create an API key at [openrouter.ai/keys](https://openrouter.ai/keys). You can set the `OPENROUTER_API_KEY` environment variable and use [`OpenRouterProvider`][pydantic_ai.providers.openrouter.OpenRouterProvider] by name: ```python from pydantic_ai import Agent agent = Agent('openrouter:anthropic/claude-3.5-sonnet') ... ``` Or initialise the model and provider directly: ```python from pydantic_ai import Agent from pydantic_ai.models.openrouter import OpenRouterModel from pydantic_ai.providers.openrouter import OpenRouterProvider model = OpenRouterModel( 'anthropic/claude-3.5-sonnet', provider=OpenRouterProvider(api_key='your-openrouter-api-key'), ) agent = Agent(model) ... ``` ## App Attribution OpenRouter has an [app attribution](https://openrouter.ai/docs/app-attribution) feature to track your application in their public ranking and analytics. You can pass in an `app_url` and `app_title` when initializing the provider to enable app attribution. ```python from pydantic_ai.providers.openrouter import OpenRouterProvider provider=OpenRouterProvider( api_key='your-openrouter-api-key', app_url='https://your-app.com', app_title='Your App', ), ... ``` ## Model Settings You can customize model behavior using [`OpenRouterModelSettings`][pydantic_ai.models.openrouter.OpenRouterModelSettings]: ```python from pydantic_ai import Agent from pydantic_ai.models.openrouter import OpenRouterModel, OpenRouterModelSettings settings = OpenRouterModelSettings( openrouter_reasoning={ 'effort': 'high', }, openrouter_usage={ 'include': True, } ) model = OpenRouterModel('openai/gpt-5') agent = Agent(model, model_settings=settings) ... ```