Docs / Credits

Credits

How the NaLU AI credit system works.

What are credits?

Credits are the unit of consumption in NaLU AI. Each API call consumes credits according to the validator used.

Free plan: 3,000 credits/month + 100 credits/day. Paid plans: monthly credits only (no daily cap).

Cost per validator

Validator Credits Starter ($5.90) Pro ($39.90)
All standard validators (name, email, CPF, CEP, phone, CNPJ, plate, postal code, yes/no, birthdate, handoff, cancel, company) 3 $0.0012 $0.00048
🧠 validate_reply 5 $0.0020 $0.00080

BRL equivalent: Starter β‰ˆ R$ 0,0058 Β· Pro β‰ˆ R$ 0,0024 per standard validation

Plan comparison

Plan Credits/month Daily cap Price
Free3,000100/day$0
Starter15,000β€”$5.90/mo
Indie50,000β€”$13.90/mo
Pro250,000β€”$39.90/mo

What happens when credits run out?

Calls return HTTP 402 with:

{
  "error":   "insufficient_credits",
  "message": "You have 0 credits remaining.",
  "upgrade": "https://naluai.dev/en/pricing"
}

No surprise charges. Your data and keys remain intact. Upgrade at any time to restore access immediately.

Checking your balance

curl https://api.naluai.dev/v1/account/credits \
  -H "Authorization: Bearer nalu_YOUR_KEY"

# Response:
{
  "plan":               "starter",
  "credits_remaining":  12847,
  "credits_used":       2153,
  "credits_total":      15000,
  "resets_at":          "2026-06-01T00:00:00Z"
}