Specifications
Supported file formats: JPG, PNG, and BMP Import methods:- IAM Delegated Access
- Signed URLs (
https
URLs only) - Direct upload of local files (256 MB max file size) Note: Direct upload currently does not support adding additional metadata and attachments, see below Python example.
Image size limitPlease note that Labelbox does not recommend labeling images larger than 9000px by 9000px. Labeling images of this size may cause annotations to be irretrievable.
Parameter | Required | Description |
---|---|---|
row_data | 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. |
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 | "IMAGE" (optional media type to provide better validation and error messaging) |
metadata_fields | No | See Metadata. |
attachments | No | See Attachments and Asset overlays. |