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

# Analyze and segment videos

> Analyze videos to generate text and extract structured, timestamped segments.

Use the Analyze API to analyze videos, generate text based on their content, and extract structured, timestamped segments.

# Choose an endpoint

* For videos under 1 hour, use the [`POST`](/v1.3/api-reference/analyze-videos/sync-analysis) method of the `/analyze` endpoint. This endpoint returns results immediately and supports real-time streaming.
* For videos up to 2 hours, a portion of a video up to 4 hours long, or video segmentation, use the [`POST`](/v1.3/api-reference/analyze-videos/create-async-analysis-task) method of the `/analyze/tasks` endpoint. This endpoint processes videos asynchronously.
* For multiple videos, use the [`POST`](/v1.3/api-reference/analyze-videos/batch-analysis/create-batch) method of the `/analyze/batches` endpoint. This endpoint processes multiple analysis requests in one batch.

**Related guide**: [Analyze videos](/v1.3/docs/guides/analyze-videos).

[**Related quickstart notebook**](https://colab.research.google.com/github/twelvelabs-io/twelvelabs-developer-experience/blob/main/quickstarts/TwelveLabs_Quickstart_Analyze.ipynb)

> Analyze videos to generate text and extract structured, timestamped segments.

## Docs

- [Batch analysis](https://docs.twelvelabs.io/api-reference/analyze-videos/batch-analysis.md): Analyze multiple videos in a single API call.
- [The batch object](https://docs.twelvelabs.io/api-reference/analyze-videos/batch-analysis/the-batch-object.md): Batch object schema for batch analysis.

## API Docs

- Analyze and segment videos [Sync analysis](https://docs.twelvelabs.io/api-reference/analyze-videos/analyze.md)
- Analyze and segment videos [Create an async analysis task](https://docs.twelvelabs.io/api-reference/analyze-videos/create-async-analysis-task.md)
- Analyze and segment videos [List async analysis tasks](https://docs.twelvelabs.io/api-reference/analyze-videos/list-async-analysis-tasks.md)
- Analyze and segment videos [Retrieve analysis task status and results](https://docs.twelvelabs.io/api-reference/analyze-videos/retrieve-analysis-task-status-results.md)
- Analyze and segment videos [Cancel an async analysis task](https://docs.twelvelabs.io/api-reference/analyze-videos/cancel-an-async-analysis-task.md)
- Analyze and segment videos [Delete an analysis task](https://docs.twelvelabs.io/api-reference/analyze-videos/delete-analysis-task.md)
- Batch analysis [Create a batch](https://docs.twelvelabs.io/api-reference/analyze-videos/batch-analysis/create-batch.md)
- Batch analysis [List batches](https://docs.twelvelabs.io/api-reference/analyze-videos/batch-analysis/list-batches.md)
- Batch analysis [Retrieve batch status](https://docs.twelvelabs.io/api-reference/analyze-videos/batch-analysis/retrieve-batch-status.md)
- Batch analysis [Retrieve batch results](https://docs.twelvelabs.io/api-reference/analyze-videos/batch-analysis/retrieve-batch-results.md)
- Batch analysis [Cancel a batch](https://docs.twelvelabs.io/api-reference/analyze-videos/batch-analysis/cancel-batch.md)
- Batch analysis [Delete a batch](https://docs.twelvelabs.io/api-reference/analyze-videos/batch-analysis/delete-batch.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.twelvelabs.io/v1.3/api-reference/analyze-videos/openapi.json)
- [OpenAPI YAML](https://docs.twelvelabs.io/v1.3/api-reference/analyze-videos/openapi.yaml)