# Pricing and credits

What every YouTube Translate operation costs, how the credit ledger works, and how prepaid purchases settle.

Credits are prepaid and metered. **One million microcredits equals one US dollar.** There is no subscription, no automatic recharge, and no minimum monthly spend.

## Price table

| Output | Unit | Price |
|---|---|---|
| Two demo videos | Per read | Free |
| Cached transcript, translation, or summary | Per read | $0.002 |
| Transcription | Per started minute, 30 minute cap | $0.01 |
| Translation | Per 1,000 input characters | $0.002 |
| Summary | Per 1,000 input characters | $0.005 |

In microcredits: a cached read is **2,000**, a transcription minute is **10,000**, translation is **2,000** per 1,000 characters, and summary is **5,000** per 1,000 characters.

## Worked examples

**A 20-second video, first time**

Transcription is charged per *started* minute, so a 20-second source costs one minute: **$0.01**.

**A 10-minute video, transcript plus Spanish subtitles**

Transcription is 10 minutes, so **$0.10**. A 10-minute transcript is roughly 9,000 characters; translating that is about 9 blocks of 1,000 characters, so roughly **$0.018**. Total around **$0.12**.

**The same video, asked for again next week**

Both artifacts are cached. The transcript read and the subtitle read are **$0.002** each. Total **$0.004**.

That last example is the reason to prefer a cached read whenever the artifact already exists. The service never starts provider work for a cached read.

## How the ledger works

1. A quote states a **maximum**. Nothing is charged yet.
2. Starting an uncached job **reserves** that maximum. Your `available` balance drops and `reserved` rises.
3. On completion the job settles at the **actual** cost, and the unused hold returns to `available`.
4. On failure the hold is released in full.

Check both numbers at any time:

```bash
curl -s https://api.youtubetranslate.com/api/account -H "X-API-Key: $YTT_API_KEY"
```

```json
{ "balance": { "available": 990000, "reserved": 0 } }
```

## Buying credits

Credits are bought as one-time prepaid packs through **Stripe Link**. The only payment method offered is Link; no card, wallet, or subscription flow is presented.

Packs are `starter` ($1), `small` ($5), and `large` ($10). A one dollar pack grants 1,000,000 microcredits.

1. Create a checkout with an account API key, or use the payment page on [your account](https://api.youtubetranslate.com/account).
2. Authorize the payment in the Stripe Link popup.
3. Credit is granted **only** after Stripe confirms the payment settled and the charge really used Link.

A payment made outside the Link flow is refunded automatically rather than granted, because the price and entitlement are tied to the Link rail.

## What happens when credit runs out

Requests that would spend credit return **`402`** with code `insufficient_credits`. Cached reads fail the same way, so keep a small buffer if a workflow must not stall. Nothing is ever served on credit.

## Free tier

New accounts receive no free processing credits. The two allowlisted demo videos are free only through the public demo endpoints and need no credentials. Normal authenticated API and MCP calls are metered, including requests for those same videos.

## Related

- [Limits and retention](/docs/limits.md) for source caps and rate limits
- [Errors and retries](/docs/errors.md) for `402` and `428` handling
- [REST API](/docs/rest-api.md) for the exact billing endpoints
