Documentation

Set up ProxyLLM, connect your subscriptions, and call the API. Every page here is also plain Markdown: append .md to its URL.

Read as Markdown

ProxyLLM is an OpenAI-compatible gateway: your apps call https://api.proxyllm.ai/v1 like they call OpenAI, and each request routes to your Codex subscription, your own Claude Code bridge, or saved provider keys.

Guides

  • Get started - Point your app at ProxyLLM and make your first request in about five minutes.
  • Connect Codex - Route requests through the ChatGPT/Codex subscription you already pay for.
  • Claude Code Bridge - Run inference on your Claude subscription through a server you own.
  • Routing keys - One key that authenticates your apps and carries the routing plan: which providers serve each request, in what order.

API reference

Start at the overview for the base URL, keys, and error codes, then see one page per endpoint:

  • Authentication - One Authorization header. Routing keys authenticate inference; account tokens authenticate management.
  • Agent signup - POST /api/auth?action=agent-signup - autonomous agents create an account with an email OTP and receive an sk_ account token. No captcha, no browser.
  • Chat completions - POST /v1/chat/completions - OpenAI-compatible chat, with streaming, tools, and lane fallback.
  • Responses - POST /v1/responses - the OpenAI Responses API, forwarded natively to Codex and OpenAI lanes.
  • Models - GET /v1/models - the gateway's model catalog, including the flagship and mini tiers.
  • Key introspection - GET /v1/key - what the routing key in the Authorization header can do, without dashboard access.
  • Blitz - POST /blitz - run up to 50 prompts through the key's routing in one request.
  • Me - GET /v1/organizations/me - who this account token belongs to and what it may do.
  • Usage - GET /v1/organizations/usage - 30-day usage summary: requests, tokens, cost, savings.
  • Routing keys - GET | POST /v1/organizations/routing-keys - list your routing keys or create one.
  • Bridges - GET | POST /v1/organizations/bridges - list your Claude Code bridges or register one.
  • Codex session - GET | POST | DELETE /v1/organizations/codex-session - Codex connection status, connect, disconnect.

New here? Start with Get started.