Skip to main content
The AI Stats Gateway gives you a single, unified API surface for accessing multiple model providers. Follow this guide to create an API key, send your first request, and adopt the conventions that keep integrations production ready.

Before you begin

Make sure you have the following in place:
  • An AI Stats account with Gateway access.
  • At least one API key generated from your dashboard.
  • An HTTP client such as curl, fetch, or axios.
  • A model ID supported by the Gateway (for example gpt-5-nano-2025-08-07).

1. Create and store an API key

  1. Log in to the AI Stats dashboard.
  2. Navigate to Gateway -> API Keys.
  3. Create a new key, give it a descriptive name, and copy the generated value.
  4. Store the key securely using your secret manager or environment variables:
# .env
AI_STATS_API_KEY="aistats_v1_sk_<kid>_<secret>"
Tip Rotate keys regularly and remove any that are no longer needed. This keeps access scoped and auditable.

2. Choose an endpoint and model

Pick the endpoint that matches your use case. The Gateway normalizes payloads across providers, so request shapes are consistent:
EndpointWhen to use it
/v1/chat/completionsConversational interfaces, agents, and assistants.
/v1/responsesMulti-step reasoning and structured responses.
/v1/messagesAnthropic-compatible messages API.
/v1/moderationsSafety and content policy checks.
/v1/images/generationsImage generation from text prompts.
Refer to the API Reference for the complete list of supported parameters and responses.

3. Send a request

Here is a minimal curl example using the chat completions endpoint:
curl https://api.phaseo.app/v1/chat/completions \
    -H "Authorization: Bearer $AI_STATS_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
        "model": "gpt-5-nano-2025-08-07",
        "messages": [
            { "role": "system", "content": "You are a helpful assistant." },
            { "role": "user", "content": "Explain the benefits of AI." }
        ]
    }'

4. Configure environments

Store your API key in environment variables for different environments:
# .env.local
AI_STATS_API_KEY="aistats_v1_sk_<kid>_<secret>"
AI_STATS_BASE_URL="https://api.phaseo.app/v1"
When making requests, always include the Authorization header with your API key:
Authorization: Bearer $AI_STATS_API_KEY

5. Next steps

Last modified on February 18, 2026