> This page is for version v1.3 (default).
> For other versions, use one of these documentation indexes:
> - v1.3 (default): https://docs.twelvelabs.io/v1.3/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.twelvelabs.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.twelvelabs.io/_mcp/server.

# Analyze videos

> Use the Playground to analyze videos and generate text based on their content.

The platform analyzes videos to generate text based on their content using a multimodal approach. This method analyzes the visuals, sounds, spoken words, and relationships between them. For guidance on writing prompts, see the [Prompt engineering](/docs/guides/analyze-videos-and-images/prompt-engineering) page.

The page uses a two-panel layout. Select a video, enter a prompt, and configure parameters in the left panel. Results appear in the right panel.

# Get started

When you open the **Analyze** page, you can start in one of the following ways:

* **Analyze your own video**: In the left panel, select a video, enter a prompt, and run analysis. See the [Procedure](#procedure) section below for the full steps.
* **Resume a previous task**: In the right panel, select the **History** tab and choose a past task to load its results.
* **Try an example**: In the right panel, select the **Examples** tab and choose a pre-built example. The example populates a video and a prompt for you and runs analysis automatically. After the results appear, you can edit the prompt and rerun the analysis.

# Procedure

1. In the left panel, select the video preview area to choose a video that you've already uploaded, or upload a new video directly from the dialog.

2. In the **prompt** field, enter a prompt that describes what you want to analyze. Your prompts can be instructive, descriptive, or phrased as questions. To include an image in your prompt, select the image icon at the bottom of the prompt field. In the **Add an image** dialog, upload a new image, choose an existing image asset, or paste an image link.

3. *(Optional)* Adjust the parameters under **Advanced Settings**. To reset all parameters to their default values, select the **Reset** button.

4. *(Optional)* To receive a structured JSON response, use the **structured\_output** section under **Advanced Settings**. You can enable structured output in two ways:

   * Select a template from **Start with templates**. A **templates** dropdown and a JSON schema preview appear below.
   * Enable the **structured\_output** toggle. The **JSON Schema Builder** modal opens immediately so you can define a schema from scratch.

   To customize the schema, select the **Edit in Builder** button. The **JSON Schema Builder** modal opens with two panels. Define your schema in the **Builder** panel (visual interface) or the **Editor** panel (raw JSON). Changes in either panel are reflected immediately in the other.

   ![](/_fern-img/c4ed6c048b09e8cc66e361a489c577b9b3bf9e1cb081252f028903264c8464b0.webp)

5. Select the **Analyze** button. The platform displays progress messages while processing. You can leave the page and return later to see the results.

# View results

Results appear in the right panel. Select the **Visual** or **JSON** tab to switch between views.

## Visual tab

The **Visual** tab shows the generated text.

![](/_fern-img/d5e34f009213506e5ee6e6cf6cba02d9c5a00c6e5a9db4c5e7252e3600002b6e.webp)

## JSON tab

The **JSON** tab shows the raw JSON response.

![](/_fern-img/3217294edf5bd05d30dcc4c91f3f9f7c5ce294a3fffdf7959d7fb73916042365.webp)

# Work with results

## Play a specific moment

If the generated text includes timestamps, select one in the **Visual** tab to play that moment.

![](/_fern-img/c87124737130c78369da82933402bae2d25f1943de9a553c4b12f7a19f475141.webp)

## View the code snippet

Select the **View Code** button to see the request as cURL, Python, or JavaScript. Copy and paste the snippet into your application.

![](/_fern-img/e1d6565f74049eb8512acd1bd0ebc37cac59a098c8e5431e12aa076c5d2936d3.webp)

## Change the prompt

To analyze the same video with a different prompt, edit the text in the **prompt** field and select the **Analyze** button to rerun the analysis.