---
title: "Quickstart"
description: "Send a first minirouter request with a literal base URL, key and model ID."
canonical_url: "https://minirouter.sh/docs"
markdown_url: "https://minirouter.sh/docs.md"
last_updated: "2026-08-04"
---

# minirouter quickstart

Base URL: https://api.minirouter.sh/v1
(The bare host https://api.minirouter.sh also works. Never append /chat/completions to the base URL. The client adds that path.)

Auth: Authorization: Bearer mr-live-<26 base58>
Get a key at https://minirouter.sh/key. No account is required, and keys are created before payment.
Prefer a recoverable key? Sign in with an email or wallet instead: https://minirouter.sh/start

## First request

    curl https://api.minirouter.sh/v1/chat/completions \
      -H "Authorization: Bearer $MINIROUTER_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "meta/llama-3.3-70b",
        "messages": [{"role":"user","content":"ping"}],
        "stream": true
      }'

Every response carries usage.cost in the body and x-minirouter-cost-usd,
x-minirouter-provider, x-minirouter-ttft-ms and x-minirouter-balance-usd headers.

## Per client

https://minirouter.sh/setup contains draft, literal configuration references. Each client remains marked unverified until its recorded compatibility fixture passes.
https://minirouter.sh/integrations lists the current verification state for Cline, Roo Code, Kilo Code, OpenCode, Continue, SillyTavern, Aider and Zed.

## When it fails

Every error string the API emits contains a URL into https://minirouter.sh/docs/errors#<code>.