OCR-A Keys

OCR-A API Keys

HLM-27 · ADR-0076 · Keys are tried in creation order. On HTTP 402, the key is auto-deprecated and the next available key is used — no restart required.

How it works

  • Keys are fetched from DB at call time (30 s cache) — no container restart needed.
  • Routing (ADR-0116): bind a key to a service (Shared = any service). The Default key is the funded fallback a service uses when it has no bound key. Order: bound-to-service → default → shared; on a 402 it spills to the next.
  • On HTTP 402 (credit quota exceeded), the key is auto-deprecated and the next active key is tried within the same request.
  • Restore a deprecated key after topping up its credit balance with the Restore button.
  • If the pool is empty, the engine falls back to its configured OCR-A environment key.