Video Operations

This page describes the main SDK methods for uploading videos and running analysis. Use upload to send files to the server and analyze to run one of several analysis modes on the uploaded videos.

For complete code walkthroughs, see SDK Usage Examples.

Available SDK Methods

  • upload – upload one or many files for later analysis
  • analyze – run different kinds of analysis on uploaded videos
  • my_videos – list your uploaded videos
  • delete_video – remove a video by ID

upload

Upload one or many local files or URLs. This wraps upload_video and accepts either a single string/Path or a list of them. Remote URLs must point directly to a video file with one of the following extensions: .mp4, .mov, .avi, or .webm.

# Single file
result = client.upload("video.mp4")

# Multiple files
batch = client.upload(["a.mp4", "b.mp4"])

analyze

Run analysis on one or more uploaded videos.

# Analyze a single video
client.analyze("abc123")

# Or several at once
client.analyze(["abc123", "def456"])

The analysis_type argument controls what kind of analysis to perform:

  • search – supply search_query="..." to quickly scan for matching clips.
  • rapid_review – pass custom_event (and optional custom_category) to generate event-only suggestions.
  • edge_case – set edge_case_category (plus optional concept_ids and mode="agent") to use the specialized edge case pipeline.

my_videos

Retrieve your uploaded videos:

videos = client.video.my_videos()

Each entry includes the video ID, filename, duration and size.

delete_video

Remove a video:

client.video.delete_video(video_id)

For a step-by-step tutorial, head over to SDK Usage Examples.

Video Operations

This page describes the main SDK methods for uploading videos and running analysis. Use upload to send files to the server and analyze to run one of several analysis modes on the uploaded videos.

For complete code walkthroughs, see SDK Usage Examples.

Available SDK Methods

  • upload – upload one or many files for later analysis
  • analyze – run different kinds of analysis on uploaded videos
  • my_videos – list your uploaded videos
  • delete_video – remove a video by ID

upload

Upload one or many local files or URLs. This wraps upload_video and accepts either a single string/Path or a list of them. Remote URLs must point directly to a video file with one of the following extensions: .mp4, .mov, .avi, or .webm.

# Single file
result = client.upload("video.mp4")

# Multiple files
batch = client.upload(["a.mp4", "b.mp4"])

analyze

Run analysis on one or more uploaded videos.

# Analyze a single video
client.analyze("abc123")

# Or several at once
client.analyze(["abc123", "def456"])

The analysis_type argument controls what kind of analysis to perform:

  • search – supply search_query="..." to quickly scan for matching clips.
  • rapid_review – pass custom_event (and optional custom_category) to generate event-only suggestions.
  • edge_case – set edge_case_category (plus optional concept_ids and mode="agent") to use the specialized edge case pipeline.

my_videos

Retrieve your uploaded videos:

videos = client.video.my_videos()

Each entry includes the video ID, filename, duration and size.

delete_video

Remove a video:

client.video.delete_video(video_id)

For a step-by-step tutorial, head over to SDK Usage Examples.