API Reference

Base URLs

OpenAI clients append paths to {base}/v1. The Anthropic base has no /v1 — the SDK adds /v1/messages automatically.

Authentication

Send the gateway key in either header. If you send both, Authorization wins.

CopyAuthorization: Bearer sk-xxxxxxxxxxxx
x-api-key: sk-xxxxxxxxxxxx

No key → 401 missing_api_key. Invalid/expired/revoked key → 401 invalid_api_key. Out of credit → 402 quota_exhausted.

Endpoints

Models

All model ids are listed below. For the live list your key is allowed to use, call GET /v1/models.

Requests

Chat completions · OpenAI

Copycurl https://api.anajaklabs.dev/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "messages": [{ "role": "user", "content": "Hello" }]
  }'

Messages · Anthropic

Copycurl https://api.anajaklabs.dev/v1/messages \
  -H "x-api-key: sk-xxxxxxxxxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 1024,
    "messages": [{ "role": "user", "content": "Hello" }]
  }'

Image generation · OpenAI

Copycurl https://api.anajaklabs.dev/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "a glowing node graph, neon yellow",
    "size": "1024x1024"
  }'

Streaming

Set "stream": true — the gateway sends text/event-stream with no buffering (no-transform). If an error occurs after the stream has started (HTTP 200 already sent) it arrives as a frame:

Copyevent: error
data: {"error":{"message":"...","type":"api_error","code":"upstream_error"}}

Usage

GET /v1/usage returns the quota for the key you send:

Copy{
  "label": "team-key",
  "tokens_total": 1000000,
  "tokens_used": 12480,
  "tokens_remaining": 987520,
  "expires_at": "2026-12-31T00:00:00.000Z",
  "status": "active",
  "rate": { "khr_per_usd": 4000 }
}

Errors

Every error uses one envelope shape. The code also comes back as the header x-gateway-error-code. Provider error text is never leaked.

Copy{
  "error": {
    "message": "Missing API key. Add header: Authorization: Bearer <your-key>",
    "type": "authentication_error",
    "code": "missing_api_key"
  }
}