📘

Supported video formats and import methods

File format: MP4
Video encoding: H.264 (also referred to as AVC)
Import methods:

  • Direct upload (256 MB max file size)
  • IAM Delegated Access
  • Signed URLs (https URLs only)

❗️

Unsupported attributes

Please note that the Labelbox Editor does not support videos with:

  • Variable frame rate
  • Frame presentation times that are negative
  • Non-square sample aspect ratios (may appear stretched or squashed)

Videos that contain these attributes will be flagged or blocked in the Editor, and will soon be flagged at the time of import as well.

When importing video data to Labelbox, your JSON file must include the following information for each video.

Parameter

Required

Description

externalId

Yes

User-generated file name or ID for the file. For the best experience, this ID should be unique.

videoUrl

Yes

https path to a cloud-hosted image. 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.

attachments

No

Attachments

[
    {
        "externalId": "google-cast.mp4",
        "videoUrl": "https://commondatastorage.googleapis.com/gtv-videos-bucket/CastVideos/dash/DesigningForGoogleCastVideo.mp4" 
    }, 
    { 
        "externalId": "bigger-blazes-video.mp4", 
        "videoUrl": "https://commondatastorage.googleapis.com/gtv-videos-bucket/CastVideos/dash/ForBiggerBlazesVideo.mp4" 
    }
]
[
    {
        "externalId": "case_video_000_001_12630-14430.mp4",
        "videoUrl": "https://lb-test-videos.s3.us-west-1.amazonaws.com/case_video_000_001_12630-14430.mp4"
    },
    {
        "externalId": "case_video_000_001_12630-14431.mp4",
        "videoUrl": "https://lb-test-videos.s3.us-west-1.amazonaws.com/case_video_000_001_12630-14431.mp4"
    }
]