Anthropic SDK drop-in integration

AI Gateway

Route Claude calls through the AI Gateway with a single base URL change. Zero vendor lock-in: always run on the best model at the lowest cost for the use case.

Claude Agent SDK

Building programmable agents with multi-turn conversations, tool use, and MCP servers? Use the Claude Agent SDK instead.

Anthropic Messages API

Endpoint details, authentication, and cache_control breakpoints on the Anthropic-compatible endpoint.

AI Gateway

Overview

The Anthropic SDK (@anthropic-ai/sdk and anthropic) is the native client for the Claude Messages API. Connect it to Toqan Router’s AI Gateway with a single base_url change and no other modifications to existing code, unlocking 500+ models across 30+ providers, fallbacks, caching, and cost tracking.

For programmable agents with multi-turn conversations, tool use, and MCP servers, see the Claude Agent SDK integration.

Key Benefits

Toqan Router’s AI Gateway enhances the Anthropic SDK with:

Complete Observability

Track every API call, token usage, and model interaction with detailed traces and analytics

Built-in Reliability

Automatic fallbacks, retries, and load balancing for production resilience

Cost Optimization

Real-time cost tracking and spend management across all AI operations

Multi-Provider Access

Access 500+ LLMs and 30+ providers through a single, unified integration

Prerequisites

Before integrating the Anthropic SDK with Toqan Router, ensure the following are in place:

A Toqan Router account and API Key
Python 3.8+ or Node.js 18+ with TypeScript support
Anthropic SDK installed

To set up an API key, see API keys & Endpoints.

Installation

npm install @anthropic-ai/sdk

pip install anthropic

Configuration

Set the Base URL to the AI Gateway and authenticate with a Toqan Router API key to route calls through the API without changing any other part of the code.

base_url: https://router.toqan.ai/eu/v3/anthropic

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  apiKey: process.env.TOQAN_API_KEY,
  baseURL: 'https://router.toqan.ai/eu/v3/anthropic',
});

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["TOQAN_API_KEY"],
    base_url="https://router.toqan.ai/eu/v3/anthropic",
)

Text Generation

Basic text generation with the Anthropic SDK through Toqan Router:

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  apiKey: process.env.TOQAN_API_KEY,
  baseURL: 'https://router.toqan.ai/eu/v3/anthropic',
});

const message = await client.messages.create({
  model: 'anthropic/claude-sonnet-5',
  max_tokens: 1024,
  messages: [
    { role: 'user', content: 'Explain the Toqan Router AI Gateway in one paragraph.' },
  ],
});

const block = message.content[0];
if (block.type === 'text') {
  console.log(block.text);
}

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["TOQAN_API_KEY"],
    base_url="https://router.toqan.ai/eu/v3/anthropic",
)

message = client.messages.create(
    model="anthropic/claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain the Toqan Router AI Gateway in one paragraph."}],
)

print(message.content[0].text)

Streaming

Stream responses for real-time output:

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  apiKey: process.env.TOQAN_API_KEY,
  baseURL: 'https://router.toqan.ai/eu/v3/anthropic',
});

const stream = client.messages.stream({
  model: 'anthropic/claude-sonnet-5',
  max_tokens: 1024,
  messages: [
    { role: 'user', content: 'Write a haiku about AI routing.' },
  ],
});

stream.on('text', (text) => {
  process.stdout.write(text);
});

await stream.finalMessage();

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["TOQAN_API_KEY"],
    base_url="https://router.toqan.ai/eu/v3/anthropic",
)

with client.messages.stream(
    model="anthropic/claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Write a haiku about AI routing."}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

Tool Use

Define tools and let the model decide when to call them. The AI Gateway forwards tool definitions and returns tool_use blocks unchanged:

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  apiKey: process.env.TOQAN_API_KEY,
  baseURL: 'https://router.toqan.ai/eu/v3/anthropic',
});

const message = await client.messages.create({
  model: 'anthropic/claude-sonnet-5',
  max_tokens: 1024,
  tools: [
    {
      name: 'get_weather',
      description: 'Get the current weather for a location',
      input_schema: {
        type: 'object',
        properties: {
          location: { type: 'string', description: 'City name, e.g. Amsterdam' },
        },
        required: ['location'],
      },
    },
  ],
  messages: [
    { role: 'user', content: 'What is the weather in Amsterdam?' },
  ],
});

for (const block of message.content) {
  if (block.type === 'tool_use') {
    console.log(`Tool: ${block.name}`, block.input);
  }
}

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["TOQAN_API_KEY"],
    base_url="https://router.toqan.ai/eu/v3/anthropic",
)

message = client.messages.create(
    model="anthropic/claude-sonnet-5",
    max_tokens=1024,
    tools=[
        {
            "name": "get_weather",
            "description": "Get the current weather for a location",
            "input_schema": {
                "type": "object",
                "properties": {
                    "location": {"type": "string", "description": "City name, e.g. Amsterdam"},
                },
                "required": ["location"],
            },
        }
    ],
    messages=[{"role": "user", "content": "What is the weather in Amsterdam?"}],
)

for block in message.content:
    if block.type == "tool_use":
        print(f"Tool: {block.name}", block.input)

Model Selection

The anthropic/ prefix routes to Claude models. Switch to any supported model from 30+ providers by changing the model value:

const message = await client.messages.create({
  model: 'openai/gpt-5.6-sol',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Explain machine learning' }],
});

message = client.messages.create(
    model="openai/gpt-5.6-sol",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain machine learning"}],
)

Browse every available model in Supported Models.

Overview

Instrument your app

Explore

Monitor

Export

Review

Data privacy & security

Framework integrations

AI Gateway

Claude Agent SDK

Anthropic Messages API

AI Gateway

Overview

Key Benefits

Complete Observability

Built-in Reliability

Cost Optimization

Multi-Provider Access

Prerequisites

Installation

Configuration

Text Generation

Streaming

Tool Use

Model Selection

AI Gateway

Claude Agent SDK

Anthropic Messages API

​AI Gateway

​Overview

​Key Benefits

Complete Observability

Built-in Reliability

Cost Optimization

Multi-Provider Access

​Prerequisites

​Installation

​Configuration

​Text Generation

​Streaming

​Tool Use

​Model Selection

AI Gateway

Overview

Key Benefits

Prerequisites

Installation

Configuration

Text Generation

Streaming

Tool Use

Model Selection