Video Management
The Vision API provides comprehensive video management capabilities for uploading, retrieving, and organizing your video content.
Upload Videos
Upload videos using either a file upload or a URL:
You can optionally assign an uploaded video to a video group by including the group_id form field. Omit the field—or set it to default—to keep the video in the default pool.
Example with file upload
Bash
Python
Example with video url
Bash
Python
Python Bulk Upload Example
Upload Parameters
file(optional): Video file to upload (mutually exclusive withvideo_url)video_url(optional): URL of the video to upload (mutually exclusive withfile)video_name(required): Name for the videovideo_absolute_start_timestamp(optional): ISO 8601 timestampindex(required): Whether to index the video for search and Q&Agroup_id(optional): Video group ID to attach the upload to. Defaults todefaultwhen omitted, and cannot be changed after upload.
Get Video
Retrieve a specific video by its ID:
Bash
Python
List Videos
List all your videos:
Bash
Python
Delete Video
Delete a video by its ID:
Bash
Python
Video Response Format
Each video response includes:
video_id: Unique identifierurl: Presigned S3 URL for accessindexing_status: Current indexing status (pending,indexing,indexed,failed)metadata: Video metadata (dimensions, duration, timestamps, etc.)indexing_type: Type of indexing appliedgroup_id: Video group identifier (defaultwhen no custom group is set)
Indexing Status
pending: Video uploaded, indexing not startedindexing: Video is currently being processedindexed: Video has been successfully indexed and is ready for search/Q&Afailed: Indexing failed, video may need to be re-uploaded