embed

Video Embeddings

Create video embeddings, check embedding task status, and retrieve embeddings from tasks or indexed videos using TwelveLabs.

When to Use This Skill

Use this skill when the user:

• Wants to create embeddings from a video ("embed this video", "create embeddings for this video")
• Asks about embedding task status ("are my embeddings ready?", "check embedding status")
• Wants to retrieve embeddings from an indexed video ("get embeddings for video abc123")
• Mentions video embeddings in any context

Instructions

Creating Embeddings from a Video

Step 1: Identify the Video Source

Extract the video path or URL from the user's message:

• Local file path: /path/to/video.mp4, ./video.mp4, ~/Videos/demo.mov
• Remote URL: https://example.com/video.mp4

If no path/URL is provided, ask the user:

Please provide the video file path or URL you'd like to create embeddings for.

Examples:
- Local file: /path/to/video.mp4 or ./video.mp4
- Remote URL: https://example.com/video.mp4

Step 2: Validate the Input

For Local Files:

1. Resolve relative paths to absolute paths
2. Verify the file exists
3. Check file extension is supported: .mp4, .mov, .avi, .mkv, .webm

For URLs:

1. Verify URL starts with http:// or https://

Step 3: Start Embeddings Task

Use the mcp__twelvelabs-mcp__start-video-embeddings-task tool:

For Local Files:

Tool: mcp__twelvelabs-mcp__start-video-embeddings-task
Parameters:
  videoFilePath: "<absolute-path-to-video>"

For URLs:

Tool: mcp__twelvelabs-mcp__start-video-embeddings-task
Parameters:
  videoUrl: "<url>"

Step 4: Report Result

On success:

Video embedding started!

Source: <filename-or-url>
Task ID: <task_id>

Embedding creation runs in the background and may take several minutes.
Ask "are my embeddings ready?" to check the progress.

---

Checking Embedding Status

When the user asks about embedding status ("are my embeddings ready?", "check embedding status"):