Quickstart

When to use this page

Use this page when you already have a Quotaflow API key and want the fastest working request.

1. Set environment variables

export QUOTAFLOW_API_KEY="qf_your_key_here"
export OPENAI_BASE_URL="https://api.quotaflow.ai/openai/v1"

Use https://api.quotaflow.ai/openai/v1 for OpenAI-compatible clients. The same qf_... key can also be enabled for Anthropic-compatible and Gemini-compatible protocol surfaces, while usage spends from the same organization or project balance.

Key and balance model

A Quotaflow key is a credential, not a separate wallet. By default, customers receive an all-model key that spends from the shared organization or project balance. Optional product-scoped keys can limit access to GPT, Claude, Gemini, images, video, or embeddings for accounting and security.

2. List models

curl "$OPENAI_BASE_URL/models" \
  -H "Authorization: Bearer $QUOTAFLOW_API_KEY"

Expected result shape. Use the ids returned by your key.

{
  "object": "list",
  "data": [
    { "id": "gpt-5.2", "object": "model", "supported_endpoint_types": ["responses", "chat"] },
    { "id": "gpt-5.3-codex", "object": "model", "supported_endpoint_types": ["responses", "chat"] },
    { "id": "gpt-5.4", "object": "model", "supported_endpoint_types": ["responses", "chat"] },
    { "id": "gpt-5.4-mini", "object": "model", "supported_endpoint_types": ["responses", "chat"] },
    { "id": "gpt-5.4-nano", "object": "model", "supported_endpoint_types": ["responses", "chat"] },
    { "id": "gpt-5.5", "object": "model", "supported_endpoint_types": ["responses", "chat"] }
  ]
}

3. Create a response

curl "$OPENAI_BASE_URL/responses" \
  -H "Authorization: Bearer $QUOTAFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "Reply with only: Quotaflow is connected.",
    "stream": false
  }'

4. Add a stable session id

For agent workflows, include a stable session id so Quotaflow can maintain continuity across related calls.

curl "$OPENAI_BASE_URL/responses" \
  -H "Authorization: Bearer $QUOTAFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-session-id: customer-or-agent-session-123" \
  -d '{
    "model": "gpt-5.5",
    "input": "Continue this coding task.",
    "stream": true
  }'

Production checklist

• Store the key in a secret manager or environment variable.
• Do not expose the key in browser code.
• Use a stable session id for long-running agents.
• Implement retry for 429, 503, and network timeouts.
• Monitor shared balance, usage by model, and usage by product in the Quotaflow dashboard.