> For the complete documentation index, see [llms.txt](https://bountyv.gitbook.io/vdocs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bountyv.gitbook.io/vdocs/youtube-tools-api/youtube-overview.md).

# Overview

Thumbnails, lyric videos, and music shorts for YouTube & social — one product surface. All endpoints below are gated by your account's `youtube` entitlement (thumbnails are gated separately by the `image` product) — calls return `403 product_disabled` if the entitlement is missing.

| Endpoint                                                                                                                                                    | Method                             | Description                                                                             |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- | --------------------------------------------------------------------------------------- |
| [Create thumbnails](/vdocs/youtube-tools-api/thumbnail-generate.md)                                                                                         | `POST /api/v1/thumbnail/generate`  | Generate 1–4 YouTube/social thumbnail variants from a brief + reference images.         |
| [Prompt assistant](/vdocs/youtube-tools-api/thumbnail-prompt.md)                                                                                            | `POST /api/v1/thumbnail/prompt`    | Turn a rough concept into an optimized thumbnail prompt. Free.                          |
| [Lyric Video](/vdocs/youtube-tools-api/lyric-video.md)                                                                                                      | `POST /api/v1/youtube/lyric-video` | Animated lyric video from a song + its lyrics. Async, billed per minute of song.        |
| [Music Short](/vdocs/youtube-tools-api/music-short.md), [Lyria](/vdocs/youtube-tools-api/music-lyria.md) and [Suno](/vdocs/youtube-tools-api/music-suno.md) | `POST /api/v1/youtube/music-short` | Trim a music section + a 9:16 cover into a 1080×1920 YouTube Short. Async, flat charge. |

## Billing at a glance

* **Thumbnails** bill per successful variant.
* **Lyric Video** bills **per minute of the song** (rounded up) — the charge is applied when the render completes, since the song length isn't known until then.
* **Music Short** is a flat charge per short.

Failed renders are always refunded. See [Credits & pricing](/vdocs/account/credits.md) for current rates.

## Async pipelines

Lyric Video and Music Short are asynchronous: the submit call returns an identifier immediately, and you poll a separate endpoint until the render finishes.

* **Lyric Video** returns a `generation_id` — poll `GET /api/v1/youtube/lyric-video/{id}` directly.
* **Music Short** returns a `job_id` — poll it like any other video job via [Job status](/vdocs/video-api/jobs.md), then download from `/api/v1/jobs/{id}/video`.

## Authentication

Most YouTube Tools endpoints use the standard header:

```
Authorization: Bearer sk_live_...
```

The **Thumbnail** endpoints (`thumbnail/generate`, `thumbnail/prompt`) are the exception — they take your key as an `apiKey` field in the request body instead, so a browser form can post directly. See [Authentication](/vdocs/authentication.md) for details.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://bountyv.gitbook.io/vdocs/youtube-tools-api/youtube-overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.