Specifications
Supported file format: MP4 Video encoding: H.264 (also referred to as AVC), H.265 Limits:- Maximum file size: 1024 MB
- Maximum frame count: 20,000
- IAM Delegated Access
- Signed URLs (
https
URLs only) - Direct upload of local files Note: Direct upload currently does not support adding additional metadata and attachments.
Frame-Count Consistency
Please note that the Labelbox Editor only supports videos which have frame-count consistency. This is achieved whenFrames Per Second (FPS) x Video Duration (Number of secs) == Total Number of Frames
While real-world videos may not always satisfy this requirement due to different encoding schemas, we warn you about this on upload with the message “Unsupported video detected” so you can proceed with caution when labeling.Why do we check for this? Because while labeling, every frame unaccounted for is a potential error.Some common examples where frame-count consistency is not achieved:- Variable frame rate
- Negative frame presentation times (PTS)
ffmpeg -i <input.mp4> -vcodec libx264 -acodec aac <output.mp4>
Unsupported attributesPlease note that the Labelbox Editor does not support videos with:
- Non-square sample aspect ratios (may appear stretched or squashed)
Parameter | Required | Description |
---|---|---|
row_data | Yes | https path to a cloud-hosted video. For IAM Delegated Access, this URL must be in virtual-hosted-style format. For older regions, your S3 bucket may be in https://<bucket-name>.s3.<region>.amazonaws.com/<key> format. If your object URLs are formatted this way, make sure they are in the virtual-hosted-style format before importing. |
global_key | No | Unique user-generated file name or ID for the file. Global keys are enforced to be unique in your org. Data rows will not be imported if its global keys are duplicated to existing data rows. |
media_type | No | "VIDEO" (optional media type to provide better validation and error messaging) |
metadata_fields | No | See Metadata. |
attachments | No | See Attachments and Asset overlays. |