Billing & Credits

CLI First

# Plan + subscription
naive billing plans
naive billing subscribe --plan starter

# Check current status
naive billing status

Plans

Plan	Price	Credits/Month	Features
Starter	$49/mo	500	All primitives, system email domain
Pro	$149/mo	2000	All primitives, custom domains, priority support

First-time subscribers get a 7-day free trial with 20 credits.

Credit Packs

One-time purchases — credits are added immediately after payment and never expire.

Pack	Credits	Price	Per Credit
Small	200	$10	$0.05
Medium	500	$23	$0.05
Large	1000	$44	$0.04
XL	2500	$100	$0.04

Larger packs are more cost-effective. Credits never expire.

naive billing subscribe --plan starter

curl -X POST https://api.usenaive.ai/v1/billing/subscribe \
  -H "Authorization: Bearer nv_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"plan": "starter"}'

Returns a checkout URL. Open it to complete payment, then verify:

naive billing status

Buy More Credits

naive billing topup --pack medium

curl -X POST https://api.usenaive.ai/v1/billing/topup \
  -H "Authorization: Bearer nv_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"pack_id": "medium"}'

Upgrade Your Plan

naive billing upgrade --plan pro

curl -X POST https://api.usenaive.ai/v1/billing/upgrade \
  -H "Authorization: Bearer nv_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"plan": "pro"}'

If you have an active subscription, this opens the billing portal where you can change plans with automatic proration.

Check Billing Status

naive billing status

Returns your current plan, subscription status, credits remaining, and period end date.

What Happens When You Run Out

Billing Blocked (no active subscription)

If your trial expires or subscription is cancelled, all operations are blocked. The error response includes available plans:

{
  "error": {
    "code": "billing_blocked",
    "message": "Your free trial has expired. Subscribe to continue.",
    "block_reason": "trial_expired",
    "plans": [
      { "id": "starter", "credits_per_month": 500, "price": "$49/mo" },
      { "id": "pro", "credits_per_month": 2000, "price": "$149/mo" }
    ]
  }
}

Insufficient Credits (balance exhausted)

If you have an active subscription but no credits left, operations fail with available credit packs:

{
  "error": {
    "code": "insufficient_credits",
    "message": "Credit balance exhausted.",
    "packs": [
      { "id": "small", "credits": 200, "price": "$10" },
      { "id": "medium", "credits": 500, "price": "$23" },
      { "id": "large", "credits": 1000, "price": "$44" },
      { "id": "xl", "credits": 2500, "price": "$100" }
    ]
  }
}

Manage Subscription

Open the billing portal to update payment method, change plans, or cancel:

naive billing portal

​CLI First

​Plans

​Credit Packs

​Subscribe to a Plan

​Buy More Credits

​Upgrade Your Plan

​Check Billing Status

​What Happens When You Run Out

​Billing Blocked (no active subscription)

​Insufficient Credits (balance exhausted)

​Manage Subscription

CLI First

Plans

Credit Packs

Subscribe to a Plan

Buy More Credits

Upgrade Your Plan

Check Billing Status

What Happens When You Run Out

Billing Blocked (no active subscription)

Insufficient Credits (balance exhausted)

Manage Subscription