The Vision API provides comprehensive video management capabilities for uploading, retrieving, and organizing your video content.
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.
file (optional): Video file to upload (mutually exclusive with video_url)video_url (optional): URL of the video to upload (mutually exclusive with file)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 to default when omitted, and cannot be changed after upload.Retrieve a specific video by its ID:
List all your videos:
Delete a video by its ID:
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 (default when no custom group is set)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