Skip to navigation

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:

pip install twelvelabs==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 page. For complete parameter specifications, see the Make any-to-video search requests 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 page. For complete parameter specifications, see the Create sync 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 and Video embeddings pages. For complete parameter specifications, see the embedding_type parameter in the API Reference section: