Symptoms

• Paid routes fail while eligible free routes may still work.
• The console shows no usable wallet or plan allowance for the request.

Likely causes

• Wallet balance is depleted or the relevant plan allowance is unavailable.
• The selected model is paid or tiered even though another field looks like zero.

How to diagnose

• Check wallet and subscription state in the billing console.
• Read access_tier and billing_mode before interpreting numeric price fields.
• Estimate the request with the live pricing page.

Fixes

• Recharge through the documented flow or choose an eligible free route.
• Reduce request size only when that meaningfully lowers the model’s billing unit.
• Do not loop retries for a deterministic balance failure.

How to verify

A small request succeeds after usable balance or eligible access is present.

Resources

• Billing and recharge
• Plans and access tiers
• Live model pricing