AI API AggregatorDocumentation

Getting started

Five steps from zero to your first generation.

  1. Register an account and verify your email.
  2. Create an API key in your dashboard. The plaintext is shown once — store it safely.
  3. Top up your balance via the Top-up page.
  4. Call POST /v1/estimate to preview the cost of a request.
  5. Call POST /v1/generations with an Idempotency-Key header to start a generation.

Estimate cost

curl -X POST https://api.example.com/v1/estimate \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "method": "google_banana/banana-1/text_to_image",
    "params": { "prompt": "a cat" }
  }'

Create a generation

curl -X POST https://api.example.com/v1/generations \
  -H "Authorization: Bearer sk_live_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "google_banana/banana-1/text_to_image",
    "params": { "prompt": "a cat" }
  }'