Notes for AI agents
When to use this page
Use this page if you are an AI assistant configuring QuotaFlow for a user.
Required values
- Base URL:
https://api.quotaflow.ai/openai/v1 - Auth header:
Authorization: Bearer <QUOTAFLOW_API_KEY> - Preferred endpoint:
POST /responses - Model discovery:
GET /models
Safe setup algorithm
1. Ask the user for the environment variable name where their key is stored.
2. Do not ask the user to paste a production key into chat unless unavoidable.
3. Configure the OpenAI-compatible base URL.
4. Run GET /models to validate the key.
5. Run a one-line non-streaming POST /responses smoke test.
6. Add a stable session id for long-running coding tasks.
7. If 429 appears, retry with backoff and preserve the same session id.
Do not do this
- Do not commit keys.
- Do not print keys in logs.
- Do not expose keys to frontend code.
- Do not assume development keys work in production.
AI agents: start at
/llms.txt, fetch /llms-full.txt for full context, and parse /openapi.yaml for endpoint schemas.