> 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.

## Marengo 3 video understanding model

TwelveLabs is proud to introduce the following new features and improvements:

> **Info**
>
> Marengo 3.0 is available as a limited, private preview. To request access to the preview version, contact us at [sales@twelvelabs.io](mailto:sales@twelvelabs.io).

* **Sports intelligence**: Improved recognition of soccer and basketball actions.
* **Faster indexing**: Significant performance improvement with the new indexing technology.
* **Extended text processing**: Maximum text length increased from 77 to 500 tokens for both search queries and text embeddings.
* **Optimized embeddings**: 512-dimensional embeddings for faster processing and reduced storage.
* **Long content support**: Process up to four hours of video content while maintaining context.

**API Changes**:

When using Marengo 3, this update affects the following existing endpoints:

* [`POST`](/v1.3/api-reference/create-embeddings-v1/text-image-audio-embeddings/create-text-image-audio-embeddings) `/embed`
  * The `text_truncate` parameter is deprecated and the maximum length for text embeddings is now 500 tokens.

* [`GET`](/v1.3/api-reference/videos/retrieve) `/indexes/:index-id/videos/:video-id` and [`GET`](/v1.3/api-reference/create-embeddings-v1/video-embeddings/retrieve-video-embeddings) `/embed/tasks/:task_id`
  * The `embedding_option` parameter  can now take the following values: `visual`, `audio`, `transcription`. For details, see the [Embedding options](/v1.3/docs/concepts/modalities#embedding-options) section.

* [`POST`](/v1.3/api-reference/any-to-video-search/make-search-request) `/search`
  * The `audio` search option now excludes human speech. A new  search option named `transcription` for finding specific spoken words and phrases will be available in a future release.
  * The maximum query length is now 500 tokens.
  * The platform no longer returns the `score` and `confidence` fields. Use the new `rank` field instead to determine the relevance of a result.

## Entity Search API

The Entity Search API enables you to search for specific people performing actions. Use cases include finding players in sports footage, tracking characters in entertainment content, and analyzing individuals in surveillance videos.

To get started, see the [Entity Search](/v1.3/docs/guides/search/entity-search) page.