1
import time
2
from twelvelabs import TwelveLabs
3
4
# 1. Initialize the client
5
client = TwelveLabs(api_key="<YOUR_API_KEY>")
6
7
# 2. Create an index
8
# An index is a container for organizing your video content
9
index = client.indexes.create(
10
    index_name="<YOUR_INDEX_NAME>",
11
    models=[{"model_name": "marengo3.0", "model_options": ["visual", "audio"]}]
12
)
13
if not index.id:
14
    raise RuntimeError("Failed to create an index.")
15
print(f"Created index: id={index.id}")
16
17
# 3. 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
# 4. Index your video
26
indexed_asset = client.indexes.indexed_assets.create(
27
    index_id=index.id,
28
    asset_id=asset.id
29
)
30
print(f"Created indexed asset: id={indexed_asset.id}")
31
32
# 5. Monitor the indexing process
33
print("Waiting for indexing to complete.")
34
while True:
35
    indexed_asset = client.indexes.indexed_assets.retrieve(
36
        index.id,
37
        indexed_asset.id
38
    )
39
    print(f"  Status={indexed_asset.status}")
40
41
    if indexed_asset.status == "ready":
42
        print("Indexing complete!")
43
        break
44
    elif indexed_asset.status == "failed":
45
        raise RuntimeError("Indexing failed")
46
47
    time.sleep(5)
48
49
# 6. Perform a search
50
search_results = client.search.query(
51
    index_id=index.id,
52
    query_text="<YOUR_QUERY>",
53
    search_options=["visual", "audio"]
54
)
55
56
# 7. Process the search results
57
print("\nSearch results:")
58
print("Each result shows a video clip that matches your query:\n")
59
for i, clip in enumerate(search_results):
60
    print(f"Result {i + 1}:")
61
    print(f"  Video ID: {clip.video_id}")  # Unique identifier of the video
62
    print(f"  Rank: {clip.rank}")  # Relevance ranking (1 = most relevant)
63
    print(f"  Time: {clip.start}s - {clip.end}s")  # When this moment occurs in the video
64
    print()