Back to Blog
English

CrazyRouter API Quick Start Guide

This article explains how to quickly integrate the Crazyrouter API, make your first call within 5 minutes, and use models such as OpenAI, Claude, Gemini, etc.

C
Crazyrouter Team
January 22, 2026 / 1699 views
Share:
CrazyRouter API Quick Start Guide

Welcome to Crazyrouter! This guide will help you integrate the API within 5 minutes and start using world-class AI models.

Why choose Crazyrouter?#

  • Unified interface: Access 300+ AI models with a single API Key
  • OpenAI compatible: No code changes needed, just replace the base_url
  • Lower cost: More affordable than official pricing, pay-as-you-go with no subscription
  • High availability: Intelligent routing with automatic failover

1. Get your API Key#

  1. Visit the Crazyrouter official site
  2. Register an account and log in to the console
  3. Go to the “Token Management” page
  4. Click “Create Token”
  5. Copy the generated API Key (starting with sk-)

Tip: Keep your API Key safe and do not expose it in public.

2. Make your first request#

Using curl#

bash
curl https://ai.crazyrouter.us/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" \
  -d '{
    "model": "gpt-5.2",
    "messages": [{"role": "user", "content": "Hello, how are you?"}],
    "temperature": 0.7
  }'
python
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://ai.crazyrouter.us/v1"
,
    default_headers={
        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
    }
)

response = client.chat.completions.create(
    model="gpt-5.2",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello, how are you?"}
    ],
    temperature=0.7,
    max_tokens=1000
)

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

Using Node.js#

javascript
import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-api-key',
  baseURL: 'https://ai.crazyrouter.us/v1'
});

async function main() {
  const response = await client.chat.completions.create({
    model: 'gpt-5.2',
    messages: [
      { role: 'system', content: 'You are a helpful assistant.' },
      { role: 'user', content: 'Hello,Please introduce yourself' }
    ],
    temperature: 0.7
  });

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

main();

Streaming output#

python
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://ai.crazyrouter.us/v1"
,
    default_headers={
        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
    }
)

stream = client.chat.completions.create(
    model="gpt-5.2",
    messages=[{"role": "user", "content": "Write a poem about spring"}],
    stream=True
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

3. Supported models#

Crazyrouter supports 300+ AI models. Here are some popular ones:

VendorModel examplesFeatures
OpenAIgpt-5.2, gpt-5, gpt-4o, o3-pro, o3-miniStrong overall capability, supports multimodality
Anthropicclaude-opus-4.5, claude-4, claude-sonnet-4Long context, strong coding ability
Googlegemini-3.0-pro, gemini-3-flash, gemini-2.5-proMultimodal with strong reasoning capability
xAIgrok-3, grok-3-mini, grok-3-visionReal-time information and deep search
DeepSeekdeepseek-r1, deepseek-v3High cost-performance, excellent Chinese support

View the full model list: Model Marketplace

4. Common parameter descriptions#

ParameterTypeDescription
modelstringModel name, e.g. gpt-5.2
messagesarrayList of conversation messages
temperaturenumberRandomness, 0–2, default 1
max_tokensintegerMaximum number of output tokens
streambooleanWhether to use streaming output
top_pnumberNucleus sampling parameter, 0–1

5. Error handling#

python
from openai import OpenAI, APIError, RateLimitError

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://ai.crazyrouter.us/v1"
,
    default_headers={
        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
    }
)

try:
    response = client.chat.completions.create(
        model="gpt-5.2",
        messages=[{"role": "user", "content": "Hello!"}]
    )
except RateLimitError:
    print("Too many requests. Please try again later.")
except APIError as e:
    print(f"API error: {e}")

6. Next steps#


Implementation Guides

Related Articles

One API Key for GPT, Claude and Gemini: A Practical Setup for Central Asia DevelopersTutorial

One API Key for GPT, Claude and Gemini: A Practical Setup for Central Asia Developers

A practical tutorial for developers in Central Asia who want to call GPT, Claude and Gemini from one OpenAI-compatible API gateway.

May 22
11|Claude Code with Crazyrouter Series 11: Chapter 8: Prompt Optimization TipsClaude Code

11|Claude Code with Crazyrouter Series 11: Chapter 8: Prompt Optimization Tips

11|Claude Code with Crazyrouter Series 11: Chapter 8: Prompt Optimization Tips. This article covers unified integration, configuration checks, and practical workflows for Claude Code and Crazyrouter, helping readers follow the site documentation to build reusable development workflows.

Jun 10
Streaming API Implementation Guide: Real-Time AI Responses with SSETutorial

Streaming API Implementation Guide: Real-Time AI Responses with SSE

Learn how to implement streaming responses from AI APIs using Server-Sent Events (SSE). Complete guide with Python, Node.js, and cURL examples for OpenAI, Claude, and Gemini.

Feb 20
Kimi K2 Thinking: Complete Guide to Moonshot's Latest ModelGuide

Kimi K2 Thinking: Complete Guide to Moonshot's Latest Model

"Complete guide to Kimi K2 Thinking by Moonshot AI. Features, benchmarks, API access, pricing comparison, and how to use it through Crazyrouter."

Feb 15
Gemini 2.5 Flash Image Generation Guide: Create AI Images with Google's ModelTutorial

Gemini 2.5 Flash Image Generation Guide: Create AI Images with Google's Model

Learn how to generate images with Gemini 2.5 Flash, Google's multimodal AI model. Includes API tutorial, code examples, and comparison with DALL-E and Midjourney.

Feb 22
Google Veo3 API Guide 2026: Storyboards, Cost Control, and Video FallbacksGuide

Google Veo3 API Guide 2026: Storyboards, Cost Control, and Video Fallbacks

A production guide to Google Veo3 API workflows, prompt structure, storyboard batching, cost control, and Crazyrouter video model routing.

Jun 5