Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ai-stats.phaseo.app/llms.txt

Use this file to discover all available pages before exploring further.

Use this recipe to get your first AI Stats integration running without picking a paid model yet. Instead of picking one free model yourself, send requests to ai-stats/free. AI Stats will choose an available free model that supports the request you are making.

​
When to use this

  • You want a working prototype before choosing a paid model.
  • You expect the best free option to change over time.
  • You want one stable model ID in application code while AI Stats handles free-provider changes behind the scenes.

​
Example request

curl https://api.phaseo.app/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ai-stats/free",
    "input": "Summarize why provider-aware free routing helps prototypes.",
    "temperature": 0.2
  }'

​
What happens behind the scenes

  1. Your request goes to the shared ai-stats/free alias.
  2. AI Stats checks which free models can handle that request.
  3. One available free model is selected and used for the response.
  4. Request details still show the exact model that ran, so you can inspect or debug it later.

​
After your first request

  • In Gateway -> Usage, open the request details and confirm which model was used.
  • If the request is blocked by workspace policy, check the request details to see which setting stopped it.
  • If no free model supports the feature you need, switch from ai-stats/free to a specific paid model instead of retrying the same request.

​
Production notes

  • Keep ai-stats/free for prototypes, demos, and low-stakes traffic.
  • If you need predictable latency, output style, or provider choice, move to a specific model once you know what works best.
  • If you need stable prompt behavior across services, pair this recipe with Presets.
Last modified on May 19, 2026