Skip to main content

Quick Start Guide

Get up and running with Korad.AI in under 30 seconds. One API key, 20+ AI models.

Step 1: Get Your API Key​

Visit korad.ai/dashboard to create your free account and get your API key.

Your key will look like: sk-korad-xxxxx...

Step 2: Configure Your Environment​

export ANTHROPIC_BASE_URL="https://api.korad.ai/v1"
export ANTHROPIC_API_KEY="sk-korad-YOUR-KEY"

Option B: In Code​

import anthropic

client = anthropic.Anthropic(
    base_url="https://api.korad.ai/v1",
    api_key="sk-korad-YOUR-KEY"
)

Step 3: Make Your First Request​

Python (Anthropic SDK)​

import anthropic

client = anthropic.Anthropic(
    base_url="https://api.korad.ai/v1",
    api_key="sk-korad-YOUR-KEY"
)

response = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{
        "role": "user",
        "content": "Hello! Explain quantum computing in simple terms."
    }]
)

print(response.content[0].text)

cURL​

curl https://api.korad.ai/v1/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-korad-YOUR-KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

JavaScript​

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

const anthropic = new Anthropic({
  baseURL: 'https://api.korad.ai/v1',
  apiKey: 'sk-korad-YOUR-KEY',
});

const response = await anthropic.messages.create({
  model: 'claude-sonnet-4-5',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Hello!' }],
});

console.log(response.content[0].text);

Step 4: Try Different Models​

Korad.AI supports 20+ models. Just change the model parameter:

# Claude 4.5 (Anthropic)
response = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain..."}]
)

# Gemini 2.5 Pro (Google)
response = client.messages.create(
    model="gemini-2.5-pro",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain..."}]
)

# Grok-3 (xAI)
response = client.messages.create(
    model="grok-3",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain..."}]
)

# DeepSeek V3 (Budget-friendly)
response = client.messages.create(
    model="deepseek-v3-chat",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain..."}]
)

Step 5: Use Tools​

All models support tools for web search, code execution, and more:

response = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    tools=[{
        "type": "computer_20241022",
        "name": "web-search",
        "description": "Search the web for current information"
    }],
    messages=[{
        "role": "user",
        "content": "What's the latest news about AI?"
    }]
)

# Model automatically calls web-search and returns results

Claude Code CLI​

# Set environment variables
export ANTHROPIC_BASE_URL="https://api.korad.ai/v1"
export ANTHROPIC_API_KEY="sk-korad-YOUR-KEY"

# Use Claude Code normally
claude "Help me refactor this function"

Cursor IDE​

  1. Open Cursor Settings → AI Models
  2. Set Base URL: https://api.korad.ai/v1
  3. Set API Key: sk-korad-YOUR-KEY
  4. Start coding!

Custom Applications​

# Works with any Anthropic-compatible code
from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.korad.ai/v1",
    api_key="sk-korad-YOUR-KEY"
)

# Your existing code works unchanged

Streaming Responses​

with client.messages.stream(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Tell me a story"}]
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

Check Your Balance​

curl https://api.korad.ai/v1/user/balance \
  -H "Authorization: Bearer sk-korad-YOUR-KEY"

Response:

{
  "api_key": "sk-korad-...",
  "balance": 42.50,
  "currency": "USD"
}

Next Steps​

  • Models — Explore all 20+ available models
  • Tools — Learn about built-in tools
  • Billing — Add funds to your account
  • API Reference — Complete API documentation

Troubleshooting​

Authentication Error (401)​

  • Check that your API key is correct
  • Verify the key format: sk-korad-xxxxx...
  • Ensure you're using the correct base URL: https://api.korad.ai/v1

Balance Zero (402)​

  • Add funds via dashboard
  • Minimum top-up is $10

Model Not Found​

  • Check the models page for valid model names
  • Use /v1/models endpoint to list available models

Rate Limiting (429)​

  • Free tier: 60 requests/minute
  • Wait and retry
  • Consider upgrading for higher limits

Need Help?​

Ready to build? Explore the API →