# Pricing & credits

> What each Clipbeat API tier costs, how credits work and how to read prices for a specific song.

Source: https://docs.clipbeat.app/pricing/

Every video made through the API is paid from the Clipbeat account's **credit balance**. The API and MCP server use
the same prices as Clipbeat Studio. There is no separate API plan and no subscription.

:::note[Prices on this page are generated]
This page is built from the same price table that Clipbeat Studio uses, on 2026-11-22. For the exact price of a
specific song, always call [`GET /v1/pricing?song_id=...`](https://docs.clipbeat.app/api/reference/operations/getpricing/). That response is
what you will be charged.
:::

## Credits

| | |
| --- | --- |
| Exchange rate | **1 USD = 20 credits** (`credits_per_usd` in every pricing and balance response) |
| Where credits come from | Credit packs bought by the account owner in Clipbeat Studio |
| Who pays | The account that owns the API key |
| Card details | Never sent through the API. When the balance is too low the API answers `402` with a `topup_url` |

Read the balance with [`GET /v1/balance`](https://docs.clipbeat.app/api/reference/operations/getbalance/) or the `get_balance` MCP tool.

## Preview

| Tier | Price | Credits | What you get |
| --- | --- | --- | --- |
| `preview` | $5 | 100 | A short lip-synced clip of your chorus with an original AI singer |

The account makes its first purchase in Clipbeat Studio before previews can be made through the API (see
[`payment_required`](https://docs.clipbeat.app/errors/#402-payment-required)).

## Full videos

Full videos are priced by **song length** and **tier**: Standard from $5, Plus from $19, Premium from $39. Song length is rounded up to whole minutes, with a
15 second tolerance (a 4:15 song is priced as 4 minutes).
Songs can be up to 20 minutes long.

| Song length | Standard | Plus | Premium |
| --- | --- | --- | --- |
| 1 min | $5 (100 credits) | $19 (380 credits) | $39 (780 credits) |
| 2 min | $5 (100 credits) | $20 (400 credits) | $39 (780 credits) |
| 3 min | $11 (220 credits) | $25 (500 credits) | $53 (1060 credits) |
| 4 min | $14 (280 credits) | $30 (600 credits) | $69 (1380 credits) |
| 5 min | $17 (340 credits) | $35 (700 credits) | $84 (1680 credits) |
| 6 min | $21 (420 credits) | $39 (780 credits) | $100 (2000 credits) |
| 8 min | $29 (580 credits) | $49 (980 credits) | $131 (2620 credits) |
| 10 min | $37 (740 credits) | $59 (1180 credits) | $162 (3240 credits) |
| 15 min | $57 (1140 credits) | $84 (1680 credits) | On request |
| 20 min | $77 (1540 credits) | $109 (2180 credits) | On request |

Premium for songs longer than 10 minutes is on request and cannot be started through the API.
In `GET /v1/pricing` such a tier shows `"available": false`.

## How a charge works

1. When you start a video, its price is **reserved** from the balance (`cost.credits_reserved`).
2. When the video finishes, the final amount is **charged** (`cost.credits_charged`).
3. Anything not charged is **returned** to the balance (`cost.credits_refunded`). If a video fails, the reserved
   credits are returned in full. If a delivered video has fewer moving shots than planned, part of the price is
   returned automatically.

`cost.usd` shows the reserved amount while the video is running and the charged amount once it has finished. See
[Video jobs](https://docs.clipbeat.app/concepts/video-jobs/#cost-fields).

## Reading prices in code

```bash
curl -s "https://api.clipbeat.app/v1/pricing?song_id=$SONG_ID" \
  -H "Authorization: Bearer $CLIPBEAT_API_KEY"
```

```json
{
  "currency": "USD",
  "credits_per_usd": 20,
  "song_id": "8c5d2f9e-2a51-4f0e-9a43-1f4f3b0d6a21",
  "tiers": [
    { "tier": "preview", "name": "Preview", "usd": 5, "credits": 100, "available": true, "lip_sync": true, "outcome": "A short lip-synced preview of your chorus with an AI singer" },
    { "tier": "standard", "name": "Standard", "usd": 14, "credits": 280, "available": true, "lip_sync": true, "outcome": "..." }
  ],
  "topup_url": "https://studio.clipbeat.app/credits",
  "note": "Payment is taken from the account's credit balance. Same prices as Clipbeat Studio."
}
```

Without `song_id` the response lists the tiers with their starting prices. The `outcome` text describes what each tier
delivers and can change; show it to your users as is.

## Refunds and money questions

Questions about a charge go to [hello@clipbeat.app](mailto:hello@clipbeat.app?subject=Clipbeat%20API%20billing).
