Quick Start

Step 1: Create an account

Sign up at api.tierup.ai/v1/auth/login using your email and password, GitHub, or Google account. Creating an account is completely free — no credit card required.

Step 2: Copy your API key

After sign-up, your API key is displayed exactly once. It follows the format:

tup_<32 hex characters>

Store it somewhere safe — a password manager or environment variable. TierUp.AI will never show it again. If you lose it, you will need to create a new account.

Step 3: Make your first request

Replace YOUR_API_KEY with the key you just copied, then run:

curl -X POST https://api.tierup.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "Hello!"}],
    "tier": 1
  }'

What just happened?

Tier 1 is free. When you sent that request, TierUp.AI:

1. Received your message and inspected the tier field.
2. Routed it to the best available model for that tier.
3. Stripped the model's identity from the response.
4. Returned a clean, OpenAI-compatible response to you.

You never need to know which underlying model ran. TierUp.AI handles model selection, fallbacks, and load balancing transparently.

Next steps

• Playground — Try the API interactively in your browser.
• Chat Completions — Full reference for the completions endpoint.
• Code Examples — Ready-to-run samples in Python, Node, and more.
• Tiers & Pricing — Understand what each tier includes and when to upgrade.