OpenRouter

OpenRouter is OpenAI-compatible: use the standard openai SDK with the OpenRouter base URL (https://openrouter.ai/api/v1). TraceRoot captures these calls through the existing OpenAI instrumentation — no new OpenRouter-specific instrumentor or enum is required. The same approach works for xAI, Moonshot, Z.AI and other OpenAI-compatible providers.

Install

Python
TypeScript

pip install traceroot openai

npm install @traceroot-ai/traceroot openai

Set up

Python
TypeScript

import os
import openai
import traceroot
from traceroot import Integration

traceroot.initialize(integrations=[Integration.OPENAI])

client = openai.OpenAI(
    api_key=os.environ["OPENROUTER_API_KEY"],
    base_url="https://openrouter.ai/api/v1",
)

import OpenAI from 'openai';
import { TraceRoot } from '@traceroot-ai/traceroot';

TraceRoot.initialize({
  instrumentModules: { openAI: OpenAI },
});

const openai = new OpenAI({
  apiKey: process.env.OPENROUTER_API_KEY,
  baseURL: 'https://openrouter.ai/api/v1',
});

Usage

Python
TypeScript

import os
import openai

client = openai.OpenAI(
    api_key=os.environ["OPENROUTER_API_KEY"],
    base_url="https://openrouter.ai/api/v1",
)

# This OpenRouter call is traced by TraceRoot's OpenAI integration
response = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "What is the capital of France?"},
    ],
)

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

import OpenAI from 'openai';

const openai = new OpenAI({
  apiKey: process.env.OPENROUTER_API_KEY,
  baseURL: 'https://openrouter.ai/api/v1',
});

// This OpenRouter call is traced by TraceRoot's OpenAI integration
const response = await openai.chat.completions.create({
  model: 'openai/gpt-4o-mini',
  messages: [
    { role: 'system', content: 'You are a helpful assistant.' },
    { role: 'user', content: 'What is the capital of France?' },
  ],
});

console.log(response.choices[0].message.content);

Verify

Run your code and confirm the trace arrives:

In the TraceRoot UI: Navigate to Tracing > Traces in TraceRoot Cloud. You should see a trace with root span ChatCompletion (OpenAI Chat Completions on TypeScript).
Via the CLI: Run traceroot traces list to inspect your recent traces from the terminal.

What gets captured

Attribute	Description
Model	Any OpenRouter model string, such as `openai/gpt-4o-mini`, `anthropic/claude-sonnet-4`, or `meta-llama/llama-4-maverick`
Messages	Input messages array
Response	Completion content
Tool calls	Function/tool call inputs and outputs when using the OpenAI SDK tool-calling API
Tokens	Prompt, completion, and total tokens when returned by the provider
Cost	Calculated when the routed model ID matches TraceRoot’s pricing table (for example, supported `openai/...`, `anthropic/...`, or `google/...` IDs); otherwise tokens are captured without cost
Latency	Request duration

Limitations

OpenRouter requests are traced through the standard OpenAI integration; token pricing requires provider-returned usage headers or recognized model mappings.

Run the example

Clone the repo and run a complete OpenRouter agent end-to-end.

Python

Run the Python OpenRouter tool-agent example

TypeScript

Run the TypeScript OpenRouter example

Next steps

Python SDK Reference

Explore the full Python SDK reference and instrumentation options.

Cost Tracking

Learn how TraceRoot calculates token costs and tracks model spend.

Overview

Native

Frameworks

Model Providers

Internal Model Providers

Install

Set up

Usage

Verify

What gets captured

Limitations

Run the example

Python

TypeScript

Next steps

Python SDK Reference

Cost Tracking

​Install

​Set up

​Usage

​Verify

​What gets captured

​Limitations

​Run the example

Python

TypeScript

​Next steps

Python SDK Reference

Cost Tracking

Install

Set up

Usage

Verify

What gets captured

Limitations

Run the example

Next steps