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.
• To use the platform, you need an API key:
  1

  If you don’t have an account, sign up for a free account.

  2

  Go to the API Key page.

  3

  Select the Copy icon next to your key.

• 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(f"  embeddings: {segment.embeddings_float[:max_elements]}")
8
        
9
client = TwelveLabs(api_key="<YOUR_API_KEY>")
10
11
res = client.embed.create(
12
    model_name="Marengo-retrieval-2.7",
13
    image_file="<YOUR_IMAGE_FILE>"
14
)
15
print(f"Created image embedding: model_name={res.model_name}")
16
if res.image_embedding is not None and res.image_embedding.segments is not None:
17
    print_segments(res.image_embedding.segments)