🟢Stable · v1

THE AAAS.BLOG PUBLIC API.

One gateway. Fifty capabilities. 500 free credits per signup.

curl https://api.aaas.blog/v1/llm \
  -H "x-api-key: $AAAS_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "prompt": "Hello, world.", "model": "auto" }'

Get started

Issue an API key in 60 seconds.

500 free credits on signup. No card required. Rotate or revoke from the dashboard at any time.

Get an API key →

Authentication.

Every request authenticates with an API key in the x-api-key header. Keys are scoped per workspace and can be rotated from the dashboard.

Request

Headers:
  x-api-key: aaas_live_xxxxxxxxxxxxxxxx

Response

401 — invalid or expired key
403 — quota exceeded
200 — authenticated

Rate limit

60 auth checks / minute / key

Pricing

Free — does not consume credits

LLM Routing.

Single endpoint that routes to the optimal model for the prompt — Haiku, Sonnet, Opus, Gemini, or GPT — based on cost, latency, and capability.

Request

POST /v1/llm
{
  "prompt": "string",
  "model": "auto" | "fast" | "deep",
  "max_tokens": 1024
}

Response

{
  "output": "string",
  "model_used": "claude-haiku-4.7",
  "credits_used": 1,
  "latency_ms": 412
}

Rate limit

120 req / minute

Pricing

1–8 credits depending on model + tokens

Composition.

Chain multiple capabilities into a single call. Pass an ordered list of steps and the gateway streams the final result.

Request

POST /v1/compose
{
  "steps": [
    { "kind": "scrape", "url": "https://example.com" },
    { "kind": "llm", "prompt": "Summarize." }
  ]
}

Response

{
  "output": "...",
  "steps_executed": 2,
  "credits_used": 4
}

Rate limit

30 req / minute

Pricing

Sum of step credits + 1 routing credit

Scraping.

Resilient web scraping with rotation, JS rendering, and structured extraction. Returns markdown-ready content.

Request

POST /v1/scrape
{
  "url": "https://example.com",
  "render_js": true,
  "extract": "markdown"
}

Response

{
  "url": "...",
  "content": "# Title...",
  "credits_used": 2
}

Rate limit

60 req / minute

Pricing

2 credits per page (4 with JS render)

Billing.

Read your live credit balance, monthly allocation, and usage. No charges happen here — read-only.

Request

GET /v1/credits

Headers:
  x-api-key: aaas_live_xxxxxxxxxxxxxxxx

Response

{
  "balance": 487,
  "allocation_monthly": 500,
  "tier": "free",
  "resets_at": "2026-05-01T00:00:00Z"
}

Rate limit

240 req / minute

Pricing

Free