Quickstart

One base URL. One token flow. Clear ops boundaries.

Connection

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.AIR_API_KEY,
  baseURL: "https://airouting.example.com/v1",
});

Connection

Point your SDK at AIRouting

Point your client at AIRouting and keep the rest unchanged.

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.AIR_API_KEY,
  baseURL: "https://airouting.example.com/v1",
});

One stable base URL.
Reuse existing auth flow.

Jump to section

Authentication

Create a tenant token

Create a tenant key in Console, then store it with your existing secrets.

curl -X POST https://airouting.example.com/v1/responses \
  -H "Authorization: Bearer $AIR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.4","input":"hello"}'

Console login uses an HTTP-only session.
New keys are shown once.

Jump to section

Operations

Operate with the admin workspace

Use Admin for endpoint health, route visibility, and platform-wide operations.

curl https://airouting.example.com/api/web/admin/providers \
  --cookie "airouting_admin_token=<session>"

Console and Admin stay isolated.
Public, Console, and Admin use separate BFFs.

Jump to section