This guide explains how to integrate Opik with OpenRouter using the OpenAI SDK. OpenRouter provides a unified API for accessing hundreds of AI models through a single OpenAI-compatible interface.

## Getting started

First, ensure you have both `opik` and `openai` packages installed:

```bash
pip install opik openai
```

You'll also need an OpenRouter API key which you can get from [OpenRouter](https://openrouter.ai/).

## Tracking OpenRouter API calls

```python
from opik.integrations.openai import track_openai
from openai import OpenAI

# Initialize the OpenAI client with OpenRouter base URL
client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key="YOUR_OPENROUTER_API_KEY"
)
client = track_openai(client)

# Optional headers for OpenRouter leaderboard
headers = {
    "HTTP-Referer": "YOUR_SITE_URL",  # Optional. Site URL for rankings
    "X-Title": "YOUR_SITE_NAME"  # Optional. Site title for rankings
}

response = client.chat.completions.create(
    model="openai/gpt-4",  # You can use any model available on OpenRouter
    extra_headers=headers,
    messages=[
        {"role": "user", "content": "Hello, world!"}
    ],
    temperature=0.7,
    max_tokens=100
)

print(response.choices[0].message.content)
```

## Available Models

OpenRouter provides access to a wide variety of models, including many open source models from different providers.

- [OpenAI models](https://openrouter.ai/openai) (GPT-4o, o1, o3-mini)
- [Anthropic models](https://openrouter.ai/anthropic) (Opus, Sonnet, Haiku)
- [Google models](https://openrouter.ai/google) (Gemini Pro, Flash, Flash Thinking)
- And many open source models

You can find the complete list of available models in the [OpenRouter documentation](https://openrouter.ai/models).

## Supported Methods

OpenRouter supports the following methods:

### Chat Completions

- `client.chat.completions.create()`: Works with all models
- Provides standard chat completion functionality
- Compatible with the OpenAI SDK interface

### Structured Outputs

- `client.beta.chat.completions.parse()`: Only compatible with OpenAI models
- For non-OpenAI models, see OpenRouter's [Structured Outputs documentation](https://openrouter.ai/docs/features/structured-outputs)

For detailed information about available methods, parameters, and best practices, refer to the [OpenRouter API documentation](https://openrouter.ai/docs).

## Related pages

- [Observability for Opik LLM Gateway with Opik](./python-opik-llm-gateway.md)
- [Observability for Kong AI Gateway with Opik](./python-kong-ai-gateway.md)
- [Observability for AISuite with Opik](./python-aisuite.md)
- [Observability for Helicone with Opik](./python-helicone.md)
- [Observability for LiteLLM with Opik](./python-litellm.md)
- [Observability for Portkey with Opik](./python-portkey.md)
- [Observability for TrueFoundry with Opik](./python-truefoundry.md)
- [Observability for Vercel AI Gateway with Opik](./python-vercel-ai-gateway.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.