# QuotaFlow Docs

QuotaFlow is an OpenAI-compatible API gateway for Codex-style agents and model clients. Use these docs to configure API keys, base URLs, OpenAI-compatible endpoints, Codex agents, capacity behavior, and error handling.

## Core machine-readable files

- [Full LLM context](https://docs.quotaflow.ai/llms-full.txt): Complete public documentation in one Markdown file.
- [OpenAPI schema](https://docs.quotaflow.ai/openapi.yaml): Machine-readable OpenAI-compatible endpoint schema.

## Start here

- [Introduction](https://docs.quotaflow.ai/introduction): What QuotaFlow is and when to use it.
- [Quickstart](https://docs.quotaflow.ai/quickstart): Send the first request.
- [Authentication](https://docs.quotaflow.ai/authentication): API key headers and security rules.
- [Get an API key](https://docs.quotaflow.ai/get-an-api-key): Customer and admin onboarding flow.

## OpenAI-compatible usage

- [Base URL](https://docs.quotaflow.ai/openai-compatible/base-url): SDK base URL and endpoint mapping.
- [Responses API](https://docs.quotaflow.ai/openai-compatible/responses): Use POST /responses.
- [Chat Completions](https://docs.quotaflow.ai/openai-compatible/chat-completions): Legacy compatibility endpoint.
- [Models](https://docs.quotaflow.ai/openai-compatible/models): List and choose available models.
- [Audio transcriptions](https://docs.quotaflow.ai/openai-compatible/audio-transcriptions): Speech-to-text setup for audio-capable accounts.

## Codex setup

- [Codex overview](https://docs.quotaflow.ai/codex/overview): Agent integration model.
- [Codex CLI](https://docs.quotaflow.ai/codex/cli): Local CLI setup.
- [Desktop agents](https://docs.quotaflow.ai/codex/desktop): IDE and desktop agent setup.
- [Capacity, queue, and failover](https://docs.quotaflow.ai/codex/capacity-queue-and-failover): Sticky routing, cooldown, queueing, and downgrade behavior.

## Examples

- [Curl examples](https://docs.quotaflow.ai/examples/curl)
- [Node.js examples](https://docs.quotaflow.ai/examples/node)
- [Python examples](https://docs.quotaflow.ai/examples/python)

## Reference

- [Errors](https://docs.quotaflow.ai/reference/errors)
- [Rate limits](https://docs.quotaflow.ai/reference/rate-limits)

## Agent instructions

If you are an AI coding agent, fetch `/llms-full.txt` for full context and `/openapi.yaml` for exact endpoints. Never ask users to paste production API keys into chat unless unavoidable. Prefer environment variables and secret managers.