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

## New embedding retrieval options

The Embed API now provides more control over the types of embeddings you retrieve. This is a breaking change that requires updating your code and affects the following endpoints:

* `/indexes/:index-id/videos/:video-id`: The `embed` parameter has been deprecated and replaced with the new `embedding_option` parameter, allowing you to retrieve specific types of embeddings. For details, see the [Retrieve video information](/api-reference/videos/retrieve) page.
* `/embed/tasks/:task_id`: You can now use the optional `embedding_option` parameter to specify which types of embeddings to retrieve. For details, see the [Retrieve video embeddings](/v1.3/api-reference/create-embeddings-v1/video-embeddings/retrieve-video-embeddings) page.

In the responses from both endpoints, each segment now includes a new field named `embedding_option` located at `video_embedding.segments[].embedding_option`, which identifies the type of embedding as either "visual-text" or "audio."

> **Note**
>
> If you use the TwelveLabs SDKs, ensure you have updated to the latest version.