# Tiers

> The four video tiers available through the API, what each one delivers and how to choose.

Source: https://docs.clipbeat.app/concepts/tiers/

Every video is made in a **tier**. The tier sets how much of the song is covered, how much lip-sync there is and how
much of the video moves. Tiers are the same as in Clipbeat Studio and cost the same.

| Tier | What you get | Priced by |
| --- | --- | --- |
| `preview` | A short lip-synced clip of your chorus with an original AI singer. The quickest way to see the look. | Fixed price |
| `standard` | A full music video for the whole song. | Song length |
| `plus` | A full music video, and the singer lip-syncs the chorus. | Song length |
| `premium` | Lip-sync on the singing shots, Clipbeat's highest quality images and motion, every scene moving. | Song length |

Prices are on [Pricing & credits](https://docs.clipbeat.app/pricing/).

## The promise for your song

The exact promise depends on the song (its length, how many scenes it needs). Read it from `GET /v1/pricing?song_id=...`.
Each entry in `tiers` has:

| Field | Description |
| --- | --- |
| `tier` | `preview`, `standard`, `plus` or `premium`. |
| `name` | Display name. |
| `usd`, `credits` | Price for this song. |
| `available` | Whether this tier can be started for this song and account. |
| `lip_sync` | Whether the tier includes lip-sync. |
| `outcome` | One sentence describing what this tier delivers for this song. |

Show `outcome` to your users as it is. It is the same sentence Clipbeat Studio shows.

## Choosing a tier

- **Not sure yet?** Start with `preview`. It is a low-cost way to check the singer, the world and the lip-sync before
  you pay for the whole song.
- **Demos, social posts, first releases:** `standard`.
- **A release where the singer should sing the hook:** `plus`.
- **The main video for a single:** `premium`.

## Availability

A tier can be unavailable for a song or account, shown as `"available": false` in the pricing response. For example,
`premium` for songs longer than 10 minutes is on request and cannot be started through the API.

Previews also need the account's first purchase in Clipbeat Studio. Before that, starting a preview returns
`402 payment_required` with a `topup_url`. Starting a tier that cannot be made returns an error (see
[Errors](https://docs.clipbeat.app/errors/)) and nothing is charged.

## Aspect ratio

Every tier can be made in `16:9` (YouTube, landscape) or `9:16` (Reels, TikTok, Shorts). Set `aspect` when you start
the video.
