All available video operations via the SDK with complete parameter reference
Parameter | Type | Default | Description |
---|---|---|---|
videos | str | Path | Sequence[str | Path] | None | Single file/URL or list of files/URLs (required) |
edge_case_category | str | None | Routes to edge case upload pipeline |
folder | str | None | Folder name for organizing uploads |
upload_timeout | int | 1200 | Timeout in seconds for upload completion |
wait_for_uploaded | bool | True | Wait until upload is complete |
video_id
and status
Parameter | Type | Default | Description |
---|---|---|---|
ids | str | Sequence[str] | None | Video ID(s) to analyze |
analysis_type | AnalysisType | None | Type of analysis to perform |
model_id | str | "Nomadic-VL-XLarge" | AI model to use |
timeout | int | 2400 | Analysis timeout in seconds |
wait_for_completion | bool | True | Wait for analysis to complete |
folder | str | None | Analyze all videos in folder (mutually exclusive with ids ) |
is_thumbnail=True
, each event in the response will include an annotated_thumbnail_url
field containing a link to the generated thumbnail with bounding box annotations.
AnalysisType | What it does | Required extra parameters | Optional extra parameters |
---|---|---|---|
AnalysisType.RAPID_REVIEW | Rapid Review: “find-this-event” detection | custom_event: str custom_category: CustomCategory | str | is_thumbnail: bool = False |
AnalysisType.EDGE_CASE | Specialized edge-case detection | edge_case_category: str | concept_ids: List[str] mode: str = "assistant" |
AnalysisType.SEARCH | Semantic search within long videos | search_query: str |
CustomCategory.DRIVING
CustomCategory.ROBOTICS
CustomCategory.AERIAL
CustomCategory.SECURITY
CustomCategory.ENVIRONMENT
Parameter | Type | Default | Description |
---|---|---|---|
folder_id | str | None | Filter videos by folder name |
Parameter | Type | Default | Description |
---|---|---|---|
video_id | str | None | ID of the video to delete (required) |
Parameter | Type | Default | Description |
---|---|---|---|
query | str | None | Natural language search query (required) |
folder | str | None | Folder name to search within (required) |
reasoning_trace_path | str | None | Path for reasoning trace |
matches
and summary
fields
Parameter | Type | Default | Description |
---|---|---|---|
video_id | str | None | ID of the video (required) |
analysis_id | str | None | ID of the analysis containing events (required) |
Parameter | Type | Default | Description |
---|---|---|---|
video_id | str | None | ID of the video (required) |
analysis_id | str | None | ID of the analysis containing events (required) |
event_idx | int | None | 0-based index of the event (required) |