Create text embeddings

This guide shows how you can create text embeddings.

The following table lists the available models for generating text embeddings and their key characteristics:

ModelDescriptionDimensionsMax tokensSimilarity metric
Marengo-retrieval-2.6Use this model to create embeddings that you can use in various downstream tasks102477Cosine similarity

The “Marengo-Retrieval-2.6” video understanding engine generates embeddings for all modalities in the same latent space. This shared space enables any-to-any searches across different types of content.

To create text embeddings, invoke the create method of the embed class specifying the following parameters:

  • engine_name: The name of the video understanding engine you want to use.
  • text: The text for which you want to create an embedding.
  • (Optional) text_truncate: Specifies the behavior for text that exceeds 77 tokens. It can take one of the following values:
    • start: Truncate the beginning of the text.
    • end: Truncate the end of the text (default).
    • none: Return an error if the text exceeds the token limit.

The response is an object containing the following fields:

  • engine_name: The name of the engine the platform has used to create this embedding.
  • text_embedding: An object that contains the embedding.

For a description of each field in the request and response, see the Create embeddings for text, image, and audio page.

Prerequisites

  • You’re familiar with the concepts that are described on the Platform overview page.
  • You have an API key. To retrieve your API key, navigate to the API Key page and log in with your credentials. Then, select the Copy icon to the right of your API key to copy it to your clipboard.

Example

The example code below creates a text embedding using the default behavior for handling text that is too long. Ensure you replace the placeholders surrounded by <> with your values.

from twelvelabs import TwelveLabs
from typing import List
from twelvelabs.models.embed import SegmentEmbedding

client = TwelveLabs(api_key="<YOUR_API_KEY>")

def print_segments(segments: List[SegmentEmbedding]):
    for segment in segments:
        print(
            f"  embedding_scope={segment.embedding_scope} start_offset_sec={segment.start_offset_sec} end_offset_sec={segment.end_offset_sec}"
        )
        print(f"  embeddings: {', '.join(str(segment.embeddings_float))}")
            
embedding = client.embed.create(
  engine_name="Marengo-retrieval-2.6",
  text="<YOUR_TEXT>",
)

print("Created a text embedding")
print(f" Engine: {embedding.engine_name}")
if embedding.text_embedding is not None and embedding.text_embedding.segments is not None:
        print_segments(embedding.text_embedding.segments)
import { TwelveLabs } from 'twelvelabs';

const client = new TwelveLabs({ apiKey:'<YOUR_API_KEY>' });
const embedding = await client.embed.create({
  engineName: 'Marengo-retrieval-2.6',
  text: '<YOUR_TEXT>'
});

console.log('Created a text embedding');
console.log(`  Engine: ${embedding.engineName}`);
console.log(`  Embedding: ${embedding.textEmbedding.values}`);