One API for verified AI routing.

Authentication

Scoped keys, server-managed credentials.

Every call carries a project-scoped Ruzzler API key as a Bearer token. Keys are bound to an organization, project, and environment; the secret is shown once at creation. Upstream provider credentials stay server-managed — your key never talks to a provider directly.

• Scope keys to one project and environment
• Send a stable idempotency key per business action
• Set maximum Credit cost before execution
• Rotate keys from the dashboard without downtime

curl https://api.ruzzler.com/v1/chat/completions \
  -H "Authorization: Bearer $RUZZLER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [{"role": "user", "content": "Summarize this contract clause."}],
    "metadata": {
      "project_id": "prj_123",
      "environment": "development",
      "idempotency_key": "8f3a2c1e-4b7d-4e9a-9c2f-1a5b6d7e8f90"
    }
  }'

Receipts & evidence

Read the evidence behind any request.

Native endpoints return what the routing layer actually did: completion status, reported verification checks, the Credits charged, the rate-card version applied, and a receipt you can store in your own billing records.

// Read the evidence behind any governed request.
const request = await fetch(
  "https://api.ruzzler.com/v1/requests/req_8f3a2c1e/receipt",
  { headers: { Authorization: `Bearer ${process.env.RUZZLER_API_KEY}` } }
).then((res) => res.json());

// {
//   "request_id": "req_8f3a2c1e",
//   "status": "completed",
//   "verification": { "state": "verified", "checks": ["route", "schema", "budget"] },
//   "credits_charged": 214,
//   "rate_card_version": "rc_2025-11",
//   "receipt_id": "rcpt_4d7e9a2b"
// }