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
        # For dynamic segmentation:
40
        # segmentation=VideoSegmentation_Dynamic(
41
        #     dynamic=VideoSegmentationDynamicDynamic(
42
        #         min_duration_sec=3  # Minimum segment duration in seconds
43
        #     )
44
        # ),
45
        # For fixed segmentation:
46
        # segmentation=VideoSegmentation_Fixed(
47
        #     fixed=VideoSegmentationFixedFixed(
48
        #         duration_sec=5  # Exact segment duration in seconds
49
        #     )
50
        # ),
51
    ),
52
)
53
print(f"Task ID: {task.id}")
54
55
# 4. Monitor the status
56
while True:
57
    task = client.embed.v_2.tasks.retrieve(task_id=task.id)
58
59
    if task.status == "ready":
60
        print(f"Task completed")
61
        break
62
    elif task.status == "failed":
63
        print("Task failed")
64
        break
65
    else:
66
        print("Task still processing...")
67
        time.sleep(5)
68
69
# 5. Process the results
70
print(f"\n{'='*80}")
71
print(f"EMBEDDINGS SUMMARY: {len(task.data)} total embeddings")
72
print(f"{'='*80}\n")
73
74
for idx, embedding_data in enumerate(task.data, 1):
75
    print(f"[{idx}/{len(task.data)}] {embedding_data.embedding_option.upper()} | {embedding_data.embedding_scope.upper()}")
76
    print(f"├─ Time range: {embedding_data.start_sec}s - {embedding_data.end_sec}s")
77
    print(f"├─ Dimensions: {len(embedding_data.embedding)}")
78
    print(f"└─ First 10 values: {embedding_data.embedding[:10]}")
79
    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
        # For dynamic segmentation:
40
        # segmentation=VideoSegmentation_Dynamic(
41
        #     dynamic=VideoSegmentationDynamicDynamic(
42
        #         min_duration_sec=3  # Minimum segment duration in seconds
43
        #     )
44
        # ),
45
        # For fixed segmentation:
46
        # segmentation=VideoSegmentation_Fixed(
47
        #     fixed=VideoSegmentationFixedFixed(
48
        #         duration_sec=5  # Exact segment duration in seconds
49
        #     )
50
        # ),
51
    ),
52
)
53
54
# 4. Process the results
55
print(f"\n{'='*80}")
56
print(f"EMBEDDINGS SUMMARY: {len(response.data)} total embeddings")
57
print(f"{'='*80}\n")
58
59
for idx, embedding_data in enumerate(response.data, 1):
60
    print(f"[{idx}/{len(response.data)}] {embedding_data.embedding_option.upper()} | {embedding_data.embedding_scope.upper()}")
61
    print(f"├─ Time range: {embedding_data.start_sec}s - {embedding_data.end_sec}s")
62
    print(f"├─ Dimensions: {len(embedding_data.embedding)}")
63
    print(f"└─ First 10 values: {embedding_data.embedding[:10]}")
64
    print()