Start
Minutes and billing
How YouTube caption credits and media minutes are counted, what the full proofread adds, what each plan includes, and where to see usage.
On this page
Listen and Watch use minutes of source video. Existing YouTube caption transcripts use a separate caption credit balance. An account starts with 30 free caption credits, and one new successful transcript costs one credit regardless of length. Purchased caption credits never expire. Stored reads, re-exports and unsuccessful items cost no extra credits.
Minutes apply to hosted media processing, and to the command-line tool when you sign in to a Scribiz account. If you run the command-line tool with your own Gemini key, no Scribiz minutes are used. See Authentication.
Minutes are counted for jobs: the web tool, the API and the remote MCP server. The command-line tool uses them when you sign in with scribiz login, and none with your own Gemini key. The Mac app uses them the same way.
What a job costs
A job is charged for the length of the source video times the multiplier for what ran. When the full proofread runs, it adds half a minute for each minute of video. See The full proofread.
| What ran | Minutes per minute of video | With the full proofread |
|---|---|---|
| Captions from other supported platforms in a media job | 0.1 | 0.6 |
| Listen | 1 | 1.5 |
| Watch | 1 | 1 |
| Both | 2 | 2.5 |
| Auto | The multiplier of the path it took | The path's rate in this column |
| A stored result for the same video | 0 | 0 |
A YouTube caption transcript uses one caption credit instead of this table, while you have one. With none left, a request for one video reads the captions at a tenth of a minute for each minute of video. Captions in any other job use a tenth of a minute for each minute of video. Without an account, your first video is free (up to 2 hours).
The MCP server without a key shares that 1 free video allowance (up to 2 hours) with the web tool, and has its own daily spend ceiling shared by everyone without a key.
The summary and chapters are included in the mode's multiplier.
Examples:
| Video | Mode | Minutes used |
|---|---|---|
| 12 minute non-YouTube lecture with captions | Auto | 1.2 |
| 12 minute lecture, no captions | Auto, resolved to Listen | 12 |
| 12 minute lecture, no captions | Auto, resolved to Listen, with the full proofread | 18 |
| 12 minute lecture | Both | 24 |
| 3 minute Reel with burned-in text | Auto, resolved to Both | 6 |
| Any video someone already ran | Any | 0 |
The YouTube caption preview quotes estimate.caption_credits. Its minute quote is zero. New successful items settle one caption credit each. A canceled batch keeps completed results and their settled charge, and releases the unused reservation.
Scribiz shows media cost before it spends anything. POST /v1/context answers with a quote: estimate.minutes is what the job charges if it runs as quoted, and 0 when everything is stored. The charge itself is made when the job ends, from what actually ran. A job that fails or is canceled is not charged. A repeat of the same request is quoted and charged as stored, with no work started.
For a long job, Scribiz stops before a step that would cost minutes you no longer have. The run ends with the error QUOTA and is charged only for what ran.
An Auto job without an account that is quoted as captions can find, once it runs, that the captions cannot be used: they cover too little of the video, are in the wrong language, or are too sparse. Scribiz then listens to the audio instead, on the Listen rate, and only when you have the minutes for it. It says so while the job runs and on the result, with the new number when it is more than the quote. If you do not have the minutes, the job ends with QUOTA and nothing is charged.
The full proofread
By default a job fixes names and terms in the transcript. The full proofread corrects the whole transcript. It runs only when a request asks for it, and it uses half a minute more for each minute of video.
So Listen with the full proofread uses 1.5 minutes per minute of video, Both uses 2.5 and captions from other platforms use 0.6. Watch reads the picture and makes no transcript to proofread, so it stays at 1.
An API request asks for it with proofread: "full", with a vocabulary when proofread is unset or "auto", or with proofread: "auto" in Both. The web tool and the remote MCP tools never ask for it. The command-line tool asks for it with --proofread or --vocabulary, and what a signed-in run is charged is under What a signed-in CLI run costs.
- It is in the quote before the run.
estimate.minutesfor Listen with the full proofread is 1.5 for each minute of video. - It is charged only if the pass ran. If it did not, because manual captions are never proofread, because your minutes ran out or because it failed, the job is charged the mode's usual minutes.
- A full pass that Scribiz adds on its own, for text mostly in a script other than Latin under
proofread: "auto", is not known before the run. It is not quoted and not charged. - A job you can pay for without the full proofread but not with it is refused before it starts, and the refusal says how many minutes it needs.
Without an account there is no proofread: "full". It is refused with account_required.
YouTube caption-only retrieval has no cleanup and uses caption credits, so it never includes the full proofread.
The CLI and the Mac app
The command-line tool is on npm. It runs with a Scribiz account or with your own Gemini key, and one credential is saved at a time.
- Signed in with
scribiz login. Media jobs use your account's minutes. The dedicatedcaptionscommands use your separate caption credit balance. Both balances are shared by the web tool, API and MCP. A free account has 30 minutes a month.scribiz whoamishows how many are left, and when they are used up the tool says when they come back. - Your own Gemini key, from
scribiz setuporGEMINI_API_KEY. Google bills that key, and no Scribiz minutes are used.
GEMINI_API_KEY in the environment wins over a saved sign-in. See Authentication. The Mac app uses them the same way.
What a signed-in CLI run costs
Signed in, the command-line tool does the work on your machine and is charged like a job: the length of the recording at the rate of the mode that ran, once. The summary is included, and the full proofread adds half a minute for each minute, as everywhere else. A stored result costs nothing.
The plan line says the number, beside what you have left, before anything is spent:
Plan: audio · 27.0 min · 218.9 min leftand the closing line says what the run was charged and what is left. A run that would not fit is refused before it starts. A run you stop part-way is charged for what it had read by then, never more than the whole. With your own Gemini key the plan is quoted in dollars, as Google bills it.
Three cases are still charged by the step: a link whose length could not be read, a recording the model had to hear again in more than a few places, and scribiz 0.1.4 or older.
Plans
| Plan | Minutes | Longest video | Notes |
|---|---|---|---|
| Anonymous | 1 free video | 2 hours | No account. One running job. A Turnstile check may run before Listen or Watch. The MCP server without a key shares the same 1 free video allowance. |
| Free | 30 per month, no rollover | 2 hours | Two running jobs. The month is a calendar month in UTC. |
| Pro | 600 per month, no rollover | 6 hours | Two running jobs. A period runs a month from the day the plan started. |
| Mac Lifetime | A one-time 300 minutes, plus the free plan's 30 per month | 2 hours | The Mac app and every 1.x update. |
The longest video is the limit for a hosted job. The command-line tool with your own Gemini key does not use Scribiz minutes, so the plan's limit does not apply to it. Signed in to an account, it uses that account's minutes. Minutes, caps and times are in UTC.
Every account also starts with 30 caption credits, once. Caption packs add 200 for $3.99, 1,200 for $11.99 or 5,000 for $23 while those packs are on sale. Caption-only retrieval has no duration multiplier.
Current prices are on the pricing page. The live checkout offer is authoritative.
Top-ups
Top-up minutes never expire and work anywhere minutes work. They are used after your plan's minutes for the period run out.
Lifetime
Lifetime covers the Mac app. It does not add a monthly allowance beyond the free plan's, because hosted minutes cost money every time they run. The one-time 300 minutes is a starting balance. Run the app with your own Gemini key for more.
When you run out
- On the web, the result page says so.
- The API answers
402with the codequota_exceeded, the engine codeQUOTA, and the minutes needed and left. See Errors and limits. - The command-line tool stops with
QUOTAand exit code 3, and says when your minutes come back. - MCP tools return an error result with the code
QUOTA. Without a key, videos already processed still work, and signing in for a free account adds 30 minutes a month. - A result that is already stored still opens for free. With no caption credit left, a YouTube transcript for one video uses your minutes instead, at 0.1 minute for each minute of video. It stops only when you have neither. Bulk batches and the YouTube caption tools of the MCP server stop when your caption credits cannot cover them. Stored reads and previously delivered transcripts do not charge another credit.
See your usage
- The dashboard shows your media minutes and separate caption credits, including credits reserved by running batches.
GET /v1/mereturns the same numbers for code. See Endpoints.- Media jobs report
minutes_charged. Caption batches and items reportcaption_credits_charged. A YouTube transcript job paid with a caption credit reportscaption_credits_chargedand zero media minutes. One that ran on your minutes reportsminutes_chargedlike any other job.
Paying
Note
Stripe takes payment for the plans and packs offered by the server. The server decides what is on sale: the pricing page shows it, and so does GET /v1/billing/offer. The offer gives each price as Stripe has it, in US dollars, and a plan is on sale only when all its prices are set up there. While nothing is on sale, POST /v1/billing/checkout answers 501 with billing_not_configured, and Scribiz grants minutes to accounts by hand.
The checkout page shows the amount you pay and any applicable tax before payment. Refund periods are listed in the terms.
Checked against the Scribiz build on 2026-10-05.