API Documentation

Authentication

Every request carries your API key as a bearer token. Keys start with air_live_ and are shown in full only once, at creation — store it in an environment variable, never in client-side code or a public repository.

Authorization: Bearer air_live_xxx

POST /v1/chat/completions

The main endpoint, matching the OpenAI Chat Completions schema. Streaming is supported with "stream": true.

curl http://localhost:3000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer air_live_xxx" \
  -d '{
    "model": "gpt-6-astra",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:3000/v1",
    api_key="air_live_xxx",
)

resp = client.chat.completions.create(
    model="gpt-6-astra",
    messages=[{"role": "user", "content": "Hello!"}],
)

print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "http://localhost:3000/v1",
  apiKey: "air_live_xxx",
});

const resp = await client.chat.completions.create({
  model: "gpt-6-astra",
  messages: [{ role: "user", content: "Hello!" }],
});

console.log(resp.choices[0].message.content);

Models

GET /models is public — no API key required — and returns the live catalog with per-model pricing and capabilities. Always resolve model ids from this endpoint rather than hard-coding them, since the catalog changes as providers release and retire models.

curl http://localhost:3000/models

Representative sample — the endpoint returns the full catalog, including input/output/cached token prices for each model.

Error Codes

Errors return a JSON body with a stable code, a human-readable message, and a request_id. Branch on code, not on message — the message text may change.

{
  "error": {
    "code": "insufficient_balance",
    "message": "…",
    "request_id": "…"
  }
}

Note: balance and model-permission failures are both 403. Distinguish them via the code field rather than the status alone.