vidcontext 0.2.0

Python SDK for the VidContext video intelligence API

vidcontext

Python SDK for the VidContext video intelligence API.

Analyze any video and get structured text output — context summaries, ad breakdowns, competitor analysis, and more.

Install

pip install vidcontext

Quick start

import vidcontext

# Uses VIDCONTEXT_API_KEY env var
result = vidcontext.analyze("video.mp4", mode="context")
print(result.result)

Async usage

from vidcontext import VidContext

async with VidContext(api_key="vc_...") as client:
    result = await client.analyze("video.mp4", mode="ad")
    print(result.result)

Sync usage

from vidcontext import SyncVidContext

with SyncVidContext(api_key="vc_...") as client:
    result = client.analyze("video.mp4", mode="context")
    print(result.result)

    credit_info = client.get_credits()
    print(f"Credits: {credit_info.credits}")

Fire-and-forget

job = vidcontext.submit("video.mp4", mode="editor")
print(job.job_id)  # Check status later

Analysis modes

Mode	Output
context	Scene-by-scene description for AI agents
editor	Shot list with timecodes for video editors
analysis	Deep content analysis with themes and structure
ad	Ad performance breakdown with scores
ecommerce	Product and UX analysis for online stores
training	Training/educational content evaluation
ugc	User-generated content quality assessment
competitor	Competitive intelligence from video content

Account methods

with SyncVidContext() as client:
    profile = client.get_profile()
    credits = client.get_credits()
    usage = client.get_usage()
    packs = client.get_credit_packs()
    keys = client.list_api_keys()

Error handling

from vidcontext import VidContextError, AuthenticationError, JobTimeoutError

try:
    result = vidcontext.analyze("video.mp4")
except AuthenticationError:
    print("Bad API key")
except JobTimeoutError:
    print("Processing took too long")
except VidContextError as e:
    print(f"API error: {e}")

Requirements

• Python 3.10+
• httpx (installed automatically)

Get an API key

Sign up at vidcontext.com and go to Developer settings.