Documentation

Deducts only from a purchased PLUS, PRO or MAX plan’s monthly, 5-hour and weekly token counters. Invitation-trial tiers do not grant pacing access. No automatic gift or wallet fallback.

Deducts only from the active LaunchTrialGrant invitation vault, including after a plan purchase. Missing, expired, revoked or exhausted gifts return 429. No plan or wallet fallback.

401: invalid, expired or revoked key or inactive account. 403: key lacks an LLM billing capability. 404: project access removed. 400: invalid schema or context too long. 413: request exceeds 64 KiB. 429: selected quota unavailable, with Retry-After. Upstream/configuration failures return 502/503. Development keys consume real tokens under the same policy.

Before inference we reserve a conservative UTF-8 prompt ceiling plus max_tokens, then settle measured input/output usage and release unused tokens. A request may receive 429 if its full reservation does not fit; reduce max_tokens or prompt size. If a non-streaming request fails before usage is known, its reservation remains for operator reconciliation. For interrupted streams, settlement uses measured usage when available, otherwise a bounded estimate; a failed settlement can leave the reservation in place.