hyperrouter-python 0.1.0

Official Python SDK for HyperRouter — AI model aggregation platform

HyperRouter Python SDK

Official Python SDK for HyperRouter — AI model aggregation platform.

Installation

pip install hyperrouter

Quick Start

from hyperrouter import HyperRouter

client = HyperRouter(api_key="mr-xxx")

response = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)

Async Usage

from hyperrouter import AsyncHyperRouter

client = AsyncHyperRouter(api_key="mr-xxx")

response = await client.chat.completions.create(
    model="anthropic/claude-sonnet-4-20250514",
    messages=[{"role": "user", "content": "Hello!"}],
)

Streaming

stream = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=[{"role": "user", "content": "Write a poem"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

Environment Variables

Variable	Description
HYPERROUTER_API_KEY	API key (starts with mr-)
HYPERROUTER_BASE_URL	Custom base URL (default: https://api.hyperrouter.ai/v1)

HyperRouter-Specific Methods

# Get detailed metadata for a request
generation = client.get_generation(trace_id="xxx")
print(generation.total_cost, generation.latency_ms)

# Check account balance
balance = client.get_balance()
print(balance.balance)

License

MIT