Skip to content
GitHubLog in
Limits & billing

Billing & credits

One unit, the credit, charged only on success. What each request costs, how audio is billed, what the plans include, and how top-ups and rollover work.

One unit: the credit

Credits are charged only when a request succeeds, so the price of a call is the price of an answer.

RequestCost
Video transcript from an existing caption track1 credit, any length
AI Fallback Transcription (by default when there is no caption track, or mode: "audio")1 credit per started 5 minutes of audio, minimum 1, charged on delivery
A channel, playlist or search listing, per page1 credit
Channel page polled with since_video_id, new videos or not1 credit
Monitor check, new videos or not1 credit, plus the transcripts it delivers
BatchPer entry, on this table: 50 sent, 47 caption transcripts back, 47 credits
GET /api/v2/me, GET /api/v2/health, polling a jobFree
Any failed, blocked, or no_transcript result, or an empty page without since_video_idFree

AI Fallback Transcription, worked out

Billed by audio duration, only once the transcript is delivered: a job that fails half-way costs nothing.

Audio lengthCredits
Under 30 seconds1
10 minutes2
20 minutes4
1 hour12
4 hours (the cap)48

Plans

PlanMonthlyCredits a monthPer 1,000Rate limitBatch capRollover
Free$0, no card5010 / min50No
Basic$51,000$5.0060 / min50Up to 2x
Pro$157,500$2.00300 / min50Up to 2x
Mega$4535,000$1.30900 / min500Up to 2x
Scale$229250,000$0.92900 / min500Up to 2x
  • Renewal: credits refill each renewal. Annual billing charges ten months for twelve and grants the credits monthly.
  • Rollover: unused plan credits carry over until the balance reaches twice the monthly allowance. On Pro, spend 3,000 of 7,500 and you renew with 12,000; leave that untouched and the next renewal stops at 15,000.
  • Free tier: the free tier does not roll over; it resets to 50 each month.
  • Upgrade: charges the full new-plan price and starts a fresh billing period, with no time-based proration or refund of the old period. The full new monthly allowance is added to your unused credits, with no cap on that grant. Basic to monthly Pro costs $15 and adds 7,500 credits.
  • Downgrade: Downgrades and switches to a shorter billing interval take effect at the next renewal.
  • Credits are never removed: a balance above the new plan's cap is kept; it just gains nothing at renewal until it falls below the cap. Top-up credits are untouched.

The billing portal shows the charge and renewal date before you confirm.

Top-ups

At your plan's per-1,000 rate, without changing the plan. Top-up credits never expire and are spent after plan credits. The card fee is mostly fixed, so the smallest bundle grows with the plan to keep one purchase at $5 or more:

PlanPer 1,000Smallest bundle
No plan$10.001,000 credits for $10
Basic$5.001,000 credits for $5
Pro$2.005,000 credits for $10
Mega$1.305,000 credits for $6.50
Scale$0.9210,000 credits for $9.20

Buy any number of bundles on the dashboard's Plans page. A lapsed subscription (a failed renewal) cannot top up until the payment method is fixed.

Running out, and your balance

  • No overage billing: at zero, requests return 402 insufficient_credits and nothing is charged. Top up or upgrade; accounts without a plan get 50 free credits back each month.
  • Your balance: GET /api/v2/me returns it, free. The MCP server's get_credits tool gives the same figure.
  • Your spend: the dashboard shows it per day and per key.