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

## Multiple-image search

TwelveLabs is proud to introduce multiple-image search, multiple-image embeddings, and fused embeddings. To use these features, upgrade to version 1.2.1 or later of the Python or Node.js SDK:

**`Python SDK`**

```sh Python SDK
pip install twelvelabs==1.2.1
```

**`Node.js SDK`**

```sh Node.js SDK
npm install twelvelabs-js@1.2.1
```

You can now use up to 10 images, alone or combined with a text query, in a single search request.

For a how-to guide, see the [Search](/v1.3/docs/guides/search) page. For complete parameter specifications, see the [Make any-to-video search requests](/v1.3/api-reference/any-to-video-search/make-search-request) page in the API Reference section.

## Multiple-image embeddings

The Embed API v2 now creates a single embedding from up to 10 images. You can also include text for context. To reference a specific image in your text, assign a name to that image and use a placeholder in the format `<@name>`. For example: "A person wearing \<@outfit> and holding \<@accessory>."

For a how-to guide, see the [Embed a query](/v1.3/docs/guides/create-embeddings/query) page. For complete parameter specifications, see the [Create sync embeddings](/v1.3/api-reference/create-embeddings-v2/create-embeddings) page in the API Reference section.

## Fused embeddings

The Embed API v2 now lets you control how the platform returns embeddings for audio and video content. You can request separate embeddings per modality, a single combined embedding that integrates all modalities, or both in the same response.

For how-to guides, see the [Audio embeddings](/v1.3/docs/guides/create-embeddings/at-scale/audio) and [Video embeddings](/v1.3/docs/guides/create-embeddings/at-scale/video) pages. For complete parameter specifications, see the `embedding_type` parameter in the API Reference section:

* [Audio embeddings](/v1.3/api-reference/create-embeddings-v2/create-embeddings#request.body.audio.embedding_type)
* [Video embeddings](/v1.3/api-reference/create-embeddings-v2/create-embeddings#request.body.video.embedding_type)