API reference

The base URL is https://api.albastov.com/v1. Authentication, errors and rate limits apply to every route and have a page each; each other page covers one route or one group of routes.

Quick example

GET /v1/models lists the chat models with their state; the request needs a key with the scope llm and loads no model.

curl https://api.albastov.com/v1/models \
  -H "Authorization: Bearer $ALBASTAR_API_KEY"

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.albastov.com/v1",
    api_key=os.environ["ALBASTAR_API_KEY"],
)
print([m.id for m in client.models.list().data])

const res = await fetch("https://api.albastov.com/v1/models", {
  headers: { Authorization: `Bearer ${process.env.ALBASTAR_API_KEY}` },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
console.log((await res.json()).data.map((m) => m.id));

The response, shortened to one model without its facts:

{
  "object": "list",
  "data": [
    {
      "id": "qwen3.8-27b",
      "object": "model",
      "created": 1793304723,
      "loaded": true,
      "state": "loaded",
      "context_length": 150000,
      "capabilities": {
        "parallel": true,
        "thinking": true,
        "vision": false,
        "max_parallel": 64
      }
    }
  ]
}

Pages

Key concepts

Base URL

https://api.albastov.com/v1. Request and response bodies are JSON, except audio files and multipart uploads where a route says so.

Authentication

Authorization: Bearer $ALBASTAR_API_KEY. An account key abk_ opens the routes of its scopes: llm, media:read, media:generate, events:publish and events:read.

Errors

Every JSON error body carries a code and a message. Branch on the HTTP status and code; the message text may change.

Rate limits

An account key makes 60 calls per minute and 5,000 per 24 hours by default; a call over the limit fails with 429 rate_limited. Both windows roll, so the per-minute limit frees calls within 60 s.

Request ids

Every response carries an X-Request-Id header. Include the value in a bug report.

User-Agent

A request with the default Python-urllib User-Agent is refused with 403 and the plain-text body error code: 1010. Every Python example that uses urllib sends "User-Agent": "my-app/1.0" for that reason; send your own program's name.

Versioning

Every route path starts with /v1. A breaking change to a stable route appears in the changelog before release; every change to a beta route gets a changelog line; an experimental route may change without notice.

Next steps