Skip to main content
All Gateway requests require a bearer API key. Create and manage keys in the AI Stats dashboard.
Calls to :free models can run with zero deposited credits. Paid-model calls require available wallet balance.

Using an API key

Include your API key in the Authorization header using the Bearer scheme:
curl https://api.phaseo.app/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5-nano",
    "input": "Hello!"
  }'

Key format and handling

  • Key format: aistats_v1_sk_<kid>_<secret>
  • Store keys in a secrets manager, not in browser code.
  • Use separate keys per app/environment for safer rotation.

Management keys

Management API keys are created and managed in the AI Stats dashboard, not through the public API. Use them for elevated administration endpoints such as Credits and Activity, and for future control-plane APIs like guardrails, key management, and workspace management.

Authentication failures

  • 401: Missing, malformed, or invalid API key.
  • 403: Key is valid but cannot access the requested capability.
Last modified on May 19, 2026