This guide shows how you can create image embeddings.

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

The “Marengo-Retrieval-2.7” video understanding model 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 an embedding for an image, you must specify at least the following parameters:

• model_name: The name of the video understanding model you want to use.
• image_url or image_file : The publicly accessible URL of your image file or the path of your image file. You must provide at least one of these parameters. If you specify both in the same request, the image_url parameter takes precedence.

The response is an object containing the following fields:

• model_name: The name of the engine the platform has used to create this embedding.
• image_embedding: An object that contains the embedding and additional information.

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.
• The images you wish to use must meet the following requirements:
  • Format: JPEG and PNG.
  • Dimension: Must be at least 128 x 128 pixels.
  • Size: Must not exceed 5MB.

Example

The example code below creates an image embedding. Ensure you replace the placeholders surrounded by <> with your values.

1
from twelvelabs import TwelveLabs
2
from typing import List
3
from twelvelabs.models.embed import SegmentEmbedding
4
5
def print_segments(segments: List[SegmentEmbedding], max_elements: int = 5):
6
    for segment in segments:
7
        print(
8
            f"  embedding_scope={segment.embedding_scope} start_offset_sec={segment.start_offset_sec} end_offset_sec={segment.end_offset_sec}"
9
        )
10
        print(f"  embeddings: {segment.embeddings_float[:max_elements]}")
11
        
12
client = TwelveLabs(api_key="<YOUR_API_KEY>")
13
14
res = client.embed.create(
15
    model_name="Marengo-retrieval-2.7",
16
    image_file="<YOUR_IMAGE_FILE>"
17
)
18
print(f"Created image embedding: model_name={res.model_name}")
19
if res.image_embedding is not None and res.image_embedding.segments is not None:
20
    print_segments(res.image_embedding.segments)