THE AAAS PUBLIC API.
One gateway. Fifty capabilities. 500 free credits per signup.
curl https://agents-as-a-service.com/api/v1/llm \ // canonical-hosts:ignore
-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_xxxxxxxxxxxxxxxxResponse
401 — invalid or expired key
403 — quota exceeded
200 — authenticatedRate 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": "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_xxxxxxxxxxxxxxxxResponse
{
"balance": 487,
"allocation_monthly": 500,
"tier": "free",
"resets_at": "2026-05-01T00:00:00Z"
}Rate limit
240 req / minute
Pricing
Free
Audio — TTS Demo.
Text-to-speech via POST /v1/audio/speech. Paste your API key, enter text, and play.
cURL equivalent
curl -X POST https://apigateway-q66ryynraa-uc.a.run.app/v1/audio/speech \
-H "Authorization: Bearer $AAAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"tts-1","input":"Hello, world.","voice":"alloy","response_format":"mp3"}' \
--output speech.mp3