Skip to content
Scribiz
Get transcript

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.

View Markdown

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 ranMinutes per minute of videoWith the full proofread
Captions from other supported platforms in a media job0.10.6
Listen11.5
Watch11
Both22.5
AutoThe multiplier of the path it tookThe path's rate in this column
A stored result for the same video00

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:

VideoModeMinutes used
12 minute non-YouTube lecture with captionsAuto1.2
12 minute lecture, no captionsAuto, resolved to Listen12
12 minute lecture, no captionsAuto, resolved to Listen, with the full proofread18
12 minute lectureBoth24
3 minute Reel with burned-in textAuto, resolved to Both6
Any video someone already ranAny0

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.minutes for 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 dedicated captions commands 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 whoami shows how many are left, and when they are used up the tool says when they come back.
  • Your own Gemini key, from scribiz setup or GEMINI_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:

Text
Plan: audio · 27.0 min · 218.9 min left

and 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

PlanMinutesLongest videoNotes
Anonymous1 free video2 hoursNo 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.
Free30 per month, no rollover2 hoursTwo running jobs. The month is a calendar month in UTC.
Pro600 per month, no rollover6 hoursTwo running jobs. A period runs a month from the day the plan started.
Mac LifetimeA one-time 300 minutes, plus the free plan's 30 per month2 hoursThe 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 402 with the code quota_exceeded, the engine code QUOTA, and the minutes needed and left. See Errors and limits.
  • The command-line tool stops with QUOTA and 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/me returns the same numbers for code. See Endpoints.
  • Media jobs report minutes_charged. Caption batches and items report caption_credits_charged. A YouTube transcript job paid with a caption credit reports caption_credits_charged and zero media minutes. One that ran on your minutes reports minutes_charged like 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.

Loading the index