Getting started
The full OpenAPI description that powers this reference lives alongside the docs. You can import it into Postman, Hoppscotch, or your favourite SDK generator to bootstrap a client automatically.AI Stats Gateway OpenAPI
View the specification file
/v1 base URL.
Authentication
All endpoints require a gateway API key to help mitigate abuse. Supply it as anAuthorization: Bearer header. Keys use the format
aistats_v1_sk_<kid>_<secret> and map back to the teams you manage inside the
dashboard.
Endpoint overview
The table below outlines the main endpoints available in the AI Stats Gateway right now:| Endpoint | Description |
|---|---|
POST /chat/completions, POST /responses, POST /messages | Text generation across OpenAI-compatible and Anthropic-compatible surfaces. |
POST /embeddings, POST /moderations | Embeddings and moderation checks. |
POST /audio/speech, POST /audio/transcriptions, POST /audio/translations | Audio generation and speech-to-text. |
POST /images/generations, POST /images/edits | Image generation and editing. |
POST /videos | Create a video generation job (asynchronous). |
GET /videos/{video_id} | Poll the video job status until complete. |
GET /videos/{video_id}/content, DELETE /videos/{video_id} | Fetch completed video bytes or delete a job. |
POST /music/generate, GET /music/generate/{music_id} | Create and poll music generation jobs. |
POST /ocr, POST /batches, GET /batches/{batch_id}, POST /files, GET /files, GET /files/{file_id} | OCR is active; batch and file endpoints are currently placeholders returning 501 not_implemented. |
GET /gateway/models, GET /data/models, GET /providers, GET /health, GET /generations?id=..., GET/POST /management/keys, GET/PATCH/DELETE /management/keys/{id} | Platform API discovery and management endpoints. |
endpoints query parameter on GET /gateway/models to reproduce the per-surface catalogues (chat, moderations, embeddings, images, video, or audio) without bouncing between separate endpoints.
The following endpoints are documented, but still under active work:
| Endpoint | Description |
|---|---|
GET /endpoints, GET /keys, POST /keys, GET /key | Coming Soon placeholder endpoints. |
usage and meta object with your usage, in both tokens and pricing, broken down into clear lines to
see what costs what, as well as detailed timing and performance metadata, such as throughput, latency, and generation time,
to support auditing and debugging.