Introduction

Extract insights from your video content with our AI that identifies objects, actions, speech, and text - enabling you to build powerful applications through simple APIs.

Sign up for a free account, retrieve your API key, and make your first search request in minutes.

1from twelvelabs import TwelveLabs
2
3client = TwelveLabs(api_key="<YOUR_API_KEY>")
4
5index = client.index.create(name="<YOUR_INDEX_NAME>", models=[{"name": "marengo2.7","options": ["visual", "audio"],}])
6print(f"Created index: id={index.id} name={index.name}")
7task = client.task.create(index_id=index.id, url="<YOUR_VIDEO_URL>")
8print(f"Created task: id={task.id}")
9
10task.wait_for_done(sleep_interval=50, callback=lambda t: print(f" Status={t.status}"))
11if task.status != "ready":
12 raise RuntimeError(f"Indexing failed with status {task.status}")
13print(f"Upload complete. The unique identifier of your video is {task.video_id}.")
14
15search_results = client.search.query(index_id=index.id, query_text="<YOUR_QUERY>", options=["visual", "audio"])
16for clip in search_results.data:
17 print(f" video_id={clip.video_id} score={clip.score} start={clip.start} end={clip.end} confidence={clip.confidence}")

Most popular

TwelveLabs models

Guides