# Apigator

> OpenAI-compatible AI gateway. One API key, hundreds of models across providers,
> pay-per-token. Base URL: https://api.apigator.ai/v1 (Bearer auth with an Apigator
> key). Everything except Claude is open to every key by default.

## Docs

- [API integration guide](https://apigator.ai/api.md): base URL, auth, model id
  rules, streaming, audio, errors. Start here to wire up an OpenAI client.
- [Models catalog](https://apigator.ai/models): full browsable model list + pricing. Each model in
  models-catalog.json carries a VERIFIED `capabilities` object (`input`, `video: native|frames|none`,
  `audio_in`) — read it to pick a real video/audio model (e.g. video WITH sound needs `video:native`).
- [Audio APIs](https://apigator.ai/audio.md): TTS (needs voice_id), Music, STT.
- [Model list endpoint](https://api.apigator.ai/v1/models): OpenAI-standard JSON.
- [Claude Code CLI setup](https://apigator.ai/claude-cli.md): separate
  Anthropic-compatible endpoint (claude.apigator.ai), allowlist-gated.

## Quick facts

- Base URL: https://api.apigator.ai/v1
- Auth: Authorization: Bearer sk-YOUR_APIGATOR_KEY
- Getting a key: sign in at https://apigator.ai with a MixerBox ID (email + a one-time
  code emailed to that address — no password); a credits key auto-provisions on first
  sign-in — copy it from Dashboard -> Keys. An autonomous agent needs a readable inbox
  for the code.
- Agent self-signup (no browser): POST /agent/signup {email} then POST
  /agent/verify {email, code, verifyToken} -> returns your sk- key + a 7-day accessToken.
  See https://apigator.ai/api.md.
- Agent account status: GET /agent/account with the /agent/verify accessToken (Bearer)
  -> {balance, spent, budget, key, claudeAllowed}. Read-only; token ~7d, re-verify on 401.
- Free tier, no top-up needed: a new key has $0 balance, which is enough for the FREE
  models (free/nemotron-nano-30b, free/nemotron-super-120b, free/gemma-4-31b). Use those
  for setup/smoke tests and anything a free model can do. You do NOT need a human to top
  up to start — only ask for a top-up if the task genuinely needs a PAID model (paid
  models return a budget_exceeded error at $0 balance).
- Model ids: openrouter/<id> for the full catalog; mixerbox/*, groq/*, together_ai/*,
  perplexity/*, deepinfra/*, openai/*, gemini/* for direct/cheaper routes.
- Claude is allowlist-gated and lives on https://claude.apigator.ai.