Build on the Kaer API
One base URL, one key and one prepaid balance for models, search, maps and mail. Chat is OpenAI-compatible, so the SDKs you use today work as they are.
export KAER_API_KEY="kaer_live_..."
curl https://api.kaer.ai/v1/chat/completions \
-H "Authorization: Bearer $KAER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "x1-kaer",
"messages": [{"role": "user", "content": "Hello, world!"}]
}'Start
Your key, your first call, the SDKs you already use.
QuickstartCreate an account, top up, make a key and send your first chat completion.AuthenticationSend your key as a bearer token or in x-api-key. Each key carries scopes; checks run in a fixed order.Key securityScopes, IP allow-lists, per-key monthly budgets, expiry, rotation and keeping kaer_live_ keys off browsers.OpenAI SDKsUse the official OpenAI SDKs with base_url https://api.kaer.ai/v1; which parameters are forwarded and which are ignored.
Endpoints
Every endpoint with its parameters, response, price and samples.
ModelsGET /v1/models lists every model you can call, with live prices per 1M tokens. No key needed.Chat completionsPOST /v1/chat/completions: OpenAI-compatible chat with tools and streaming, billed per token at the model's rate.Streamingstream: true returns server-sent events; the last chunk carries usage and the exact cost. 90 s idle and 15 min limits.SearchPOST /v1/search runs one query on the web, fast, deep or auto lane: $0.0005 to $0.003 per query, by the lane that served it.Batch searchPOST /v1/search/batch runs up to 100 queries in one call with shared options; each served row is billed like a single search.ImagesPOST /v1/images finds licensed photos, diagrams and illustrations for a subject, with credit lines. $0.002 per call.Search pricingSearch is billed per query by the lane that served it (web $0.0005, fast $0.001, deep $0.003); batch rows bill like single searches; images $0.002 per call.MapsGET /v1/maps?action=… covers geocoding, routing, places, transit, traffic and weather: $0.00005 per request ($0.05 per 1,000; site images $0.005 per 1,000), only when answered.MailPOST /v1/mail/send sends transactional email from Kaer's sending domain on Build and up: $0.001 per message plus $0.0005 per recipient, paid credit only.AccountGET /v1/me returns the calling key, its scopes, your tier and balances. Free; needs the models scope.
Reference
Errors, headers, limits, billing and privacy.
Response headersx-request-id, x-kaer-cost-usd, the x-ratelimit-* headers and Retry-After: which responses carry them and what they mean.ErrorsEvery error code: HTTP status, meaning and fix. Errors are OpenAI-shaped; branch on code.Rate limits and tiersRequests per minute per key and account, concurrent streams, monthly caps and batch sizes per tier, the edge ceiling, and how tiers rise.IdempotencyOnly POST /v1/mail/send takes an Idempotency-Key. Other calls run and bill again when retried.BillingStrictly prepaid: holds before work, settlement at actual cost, top-ups from $5 with bonuses, automatic top-up, refunds and disputes.PrivacyThe request log holds metadata only: no prompts, completions, queries, coordinates or email bodies; client IPs as keyed hashes cleared after 90 days.ChangelogDated changes to the API and these docs.