📘

Supported file formats and import methods

File formats: MP3, WAV, M4A
Import methods:

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

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

Parameter

Required

Description

externalId

Yes

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

audioUrl

Yes

https path to a cloud-hosted audio file.

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": "sample-9s.mp3",
        "audioUrl": "https://samplelib.com/lib/preview/mp3/sample-9s.mp3" 
    }, 
    { 
        "externalId": "sample-6s.mp3", 
        "audioUrl": "https://samplelib.com/lib/preview/mp3/sample-6s.mp3" 
    }
]
[
    {
        "externalId": "case_video_000_001_12630-14430.mp4",
        "audioUrl": "https://lb-test-data.s3.us-west-1.amazonaws.com/library001.mp3"
    },
    {
        "externalId": "case_video_000_001_12630-14431.mp4",
        "audioUrl": "https://lb-test-videos.s3.us-west-1.amazonaws.com/music_library002.mp3"
    }
]