Python SDK

pip install videodb

import videodb

# Connect using environment variable
conn = videodb.connect()

# Or pass API key directly
conn = videodb.connect(api_key="your-api-key")

export VIDEODB_API_KEY="your-api-key"

import videodb

conn = videodb.connect()

# Upload a video
coll = conn.get_collection()
video = coll.upload(url="https://www.youtube.com/watch?v=example")

# Index for search
video.index_spoken_words()

# Search with natural language
results = video.search("key moments")
for shot in results.shots:
    print(f"{shot.start}s: {shot.text}")

# Create a capture session and generate a client token
cap = conn.create_capture_session(end_user_id="user_123")
token = conn.generate_client_token(expires_in=600)

pip install "videodb[capture]"