1
import time
2
from twelvelabs import (
3
    TwelveLabs,
4
    VideoInputRequest,
5
    MediaSource,
6
    # For dynamic segmentation uncomment the next two lines:
7
    # VideoSegmentation_Dynamic,
8
    # VideoSegmentationDynamicDynamic,
9
    # For fixed segmentation uncomment the next two lines:
10
    # VideoSegmentation_Fixed,
11
    # VideoSegmentationFixedFixed,
12
)
13
14
# 1. Initialize the client
15
client = TwelveLabs(api_key="<YOUR_API_KEY>")
16
17
# 2. Upload a video
18
asset = client.assets.create(
19
    method="url",
20
    url="<YOUR_VIDEO_URL>" # Use direct links to raw media files. Video hosting platforms and cloud storage sharing links are not supported
21
    # Or use method="direct" and file=open("<PATH_TO_VIDEO_FILE>", "rb") to upload a file from the local file system
22
)
23
print(f"Created asset: id={asset.id}")
24
25
# 3. Process your video
26
task = client.embed.v_2.tasks.create(
27
    input_type="video",
28
    model_name="marengo3.0",
29
    video=VideoInputRequest(
30
        media_source=MediaSource(
31
            asset_id=asset.id,
32
            # url="<YOUR_VIDEO_URL>", # Use direct links to raw media files. Video hosting platforms and cloud storage sharing links are not supported
33
            # base_64_string="<BASE_64_ENCODED_DATA>",
34
        ),
35
        # start_sec=0,
36
        # end_sec=10,
37
        # embedding_option=["visual", "audio", "transcription"],
38
        # embedding_scope=["clip", "asset"],
39
        # embedding_type=["separate_embedding", "fused_embedding"],
40
        # For dynamic segmentation:
41
        # segmentation=VideoSegmentation_Dynamic(
42
        #     dynamic=VideoSegmentationDynamicDynamic(
43
        #         min_duration_sec=3  # Minimum segment duration in seconds
44
        #     )
45
        # ),
46
        # For fixed segmentation:
47
        # segmentation=VideoSegmentation_Fixed(
48
        #     fixed=VideoSegmentationFixedFixed(
49
        #         duration_sec=5  # Exact segment duration in seconds
50
        #     )
51
        # ),
52
    ),
53
)
54
print(f"Task ID: {task.id}")
55
56
# 4. Monitor the status
57
while True:
58
    task = client.embed.v_2.tasks.retrieve(task_id=task.id)
59
60
    if task.status == "ready":
61
        print(f"Task completed")
62
        break
63
    elif task.status == "failed":
64
        print("Task failed")
65
        break
66
    else:
67
        print("Task still processing...")
68
        time.sleep(5)
69
70
# 5. Process the results
71
print(f"\n{'='*80}")
72
print(f"EMBEDDINGS SUMMARY: {len(task.data)} total embeddings")
73
print(f"{'='*80}\n")
74
75
for idx, embedding_data in enumerate(task.data, 1):
76
    print(f"[{idx}/{len(task.data)}] {embedding_data.embedding_option.upper()} | {embedding_data.embedding_scope.upper()}")
77
    print(f"├─ Time range: {embedding_data.start_sec}s - {embedding_data.end_sec}s")
78
    print(f"├─ Dimensions: {len(embedding_data.embedding)}")
79
    print(f"└─ First 10 values: {embedding_data.embedding[:10]}")
80
    print()

1
import time
2
from twelvelabs import (
3
    TwelveLabs,
4
    VideoInputRequest,
5
    MediaSource,
6
    # For dynamic segmentation uncomment the next two lines:
7
    # VideoSegmentation_Dynamic,
8
    # VideoSegmentationDynamicDynamic,
9
    # For fixed segmentation uncomment the next two lines:
10
    # VideoSegmentation_Fixed,
11
    # VideoSegmentationFixedFixed,
12
)
13
14
# 1. Initialize the client
15
client = TwelveLabs(api_key="<YOUR_API_KEY>")
16
17
# 2. Upload a file
18
asset = client.assets.create(
19
    method="url",
20
    url="<YOUR_VIDEO_URL>" # Use direct links to raw media files. Video hosting platforms and cloud storage sharing links are not supported
21
    # Or use method="direct" and file=open("<PATH_TO_VIDEO_FILE>", "rb") to upload a file from the local file system
22
)
23
print(f"Created asset: id={asset.id}")
24
25
# 3. Create video embeddings
26
response = client.embed.v_2.create(
27
    input_type="video",
28
    model_name="marengo3.0",
29
    video=VideoInputRequest(
30
        media_source=MediaSource(
31
            asset_id=asset.id,
32
            # url="<YOUR_VIDEO_URL>", # Use direct links to raw media files. Video hosting platforms and cloud storage sharing links are not supported
33
            # base_64_string="<BASE_64_ENCODED_DATA>",
34
        ),
35
        # start_sec=0,
36
        # end_sec=10,
37
        # embedding_option=["visual", "audio", "transcription"],
38
        # embedding_scope=["clip", "asset"],
39
        # embedding_type=["separate_embedding", "fused_embedding"],
40
        # For dynamic segmentation:
41
        # segmentation=VideoSegmentation_Dynamic(
42
        #     dynamic=VideoSegmentationDynamicDynamic(
43
        #         min_duration_sec=3  # Minimum segment duration in seconds
44
        #     )
45
        # ),
46
        # For fixed segmentation:
47
        # segmentation=VideoSegmentation_Fixed(
48
        #     fixed=VideoSegmentationFixedFixed(
49
        #         duration_sec=5  # Exact segment duration in seconds
50
        #     )
51
        # ),
52
    ),
53
)
54
55
# 4. Process the results
56
print(f"\n{'='*80}")
57
print(f"EMBEDDINGS SUMMARY: {len(response.data)} total embeddings")
58
print(f"{'='*80}\n")
59
60
for idx, embedding_data in enumerate(response.data, 1):
61
    print(f"[{idx}/{len(response.data)}] {embedding_data.embedding_option.upper()} | {embedding_data.embedding_scope.upper()}")
62
    print(f"├─ Time range: {embedding_data.start_sec}s - {embedding_data.end_sec}s")
63
    print(f"├─ Dimensions: {len(embedding_data.embedding)}")
64
    print(f"└─ First 10 values: {embedding_data.embedding[:10]}")
65
    print()