Subscription

Get plan and credit balance

Changed on

Returns your current plan and credit balance. Call this before generating videos to check you have enough credits.

Paid plans add credits each billing cycle (monthly or yearly). Credits never expire.

Plans: credits and paid features come with a plan. Your plan and credits are managed at https://app.aituber.app/dashboard/billing. Plans are bought on the website, not through the API.

get/subscription

Request

  • Base URL
    https://app.aituber.app/api/v1
  • Auth
    HTTP bearer

Response

OK

planstring required

Your current plan. Determines feature access and per-cycle credit allocation. Values: "Free", "Hobby", "Creator", "Growth", "Pro", "Studio", "Agency", "Business", "Enterprise".

status'active' | 'canceled' | 'past_due' | 'trialing' | 'free' required

Subscription status. "active" means your plan is fully operational. "canceled" means it will end at the current period. "past_due" means payment failed (credits still available until resolved). "trialing" means you are in a free trial. "free" means no paid subscription.

creditsinteger required

Credits available to spend right now. Check this before generating a video. If a generation request exceeds your balance, it will return a PAYMENT_REQUIRED error.

monthlyCreditsinteger nullable required

Credits included with your plan each billing cycle (monthly plans bill monthly; yearly plans grant the full year up front). Null on the Free plan.

Changes