For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Sample appsIntegrationsDiscordPlaygroundDevEx repo
GuidesSDK ReferenceAPI Reference
GuidesSDK ReferenceAPI Reference
  • Get Started
    • Introduction
    • Quickstart
    • Manage your plan
    • Rate limits
    • Release notes
    • Migration guide
  • Guides
    • Search
    • Analyze videos
    • Segment videos
    • Create embeddings
  • Concepts
    • Models
    • Upload and processing methods
    • Indexes
    • Modalities
    • Multimodal large language models
  • Cloud partner integrations
    • Amazon Bedrock
  • Advanced
    • Organizations
    • Fine-tuning
    • Webhooks
    • Metadata
    • Model context protocol
    • Claude Code Plugin
  • Resources
    • Platform overview
    • Playground
      • Upload and manage assets
      • Manage indexes
      • Search
      • Analyze videos
      • Segment videos
      • Visualize embeddings
      • Examples
    • TwelveLabs SDKs
    • Frequently asked questions
    • Use cases
    • Sample applications
    • Partner integrations
    • From the community
LogoLogo
Sample appsIntegrationsDiscordPlaygroundDevEx repo
On this page
  • User interface
  • Typical workflow
ResourcesPlayground

Visualize embeddings

Was this page helpful?
Previous

Examples

Next
Built with

Use the Playground to analyze semantic relationships between your video content and text queries. The visualization displays up to 500 clips from your selected index as interactive data points in a two-dimensional space. Dots that cluster together indicate content with similar characteristics. Each dot in the visualization has a distinct color:

  • Light green: Represents video clips.
  • Dark green: Indicates the currently selected video clip.
  • Orange: Represents your text query

When you enter a text query, its position relative to video clips indicates semantic similarity - clips positioned closer to your query are more semantically similar to the text you entered.

User interface

The following image shows the user interface and the key elements you can use to interact with the visualization:

  1. Visualization area: Displays dots representing video clips and the embedding for your text query.
  2. Create a text embedding: Use this text field to enter your text query. Note that your text cannot exceed 77 tokens. The token count is displayed at the bottom.
  3. View controls: Use these buttons to adjust the visualization:
    • Zoom in
    • Zoom out
    • Fit: Reset the view to show all points
  4. Legend: Shows what the different colors represent.
  5. Selected embedding: Shows detailed information about the selected embedding. including a video player.

Typical workflow

Follow the steps below to explore semantic relationships in your video content:

  1. From the Indexes page, select an index.
  2. Choose the Embed tab
  3. Enter a text query to find relevant video segments.
  4. Explore relationships by:
    • Observing clusters of similar content
    • Adjusting the view to focus on specific areas using the buttons in the View controls area or your mouse.
    • Selecting dots to preview video segments
  5. View the code to implement similar functionality in your application.