Labelbox

Connecting Cloud Data

Labelbox connects to hosted data via URL; follow these steps to get setup

Generate URLs for each Data Asset

You will first need to generate or retrieve the URL links for each data asset from your cloud storage location. If your data is not private, you can simply make the data in your cloud folder public and generate/retrieve the URLs.

Private Data Using Signed URLs

For private data, you must generate signed URLs for each data asset. A signed URL is a feature that allows you to protect your data from unauthorized access with a key. It adds a unique key to the URL such that the only way to access the data via the URL is with this URL + key. A signed URL looks like http://example.com/filename?hash=DMF1ucDxtqgxwYQ==. In regards to Labelbox, the only data that is passed to us is this signed URL and not the data files themselves.

For added security, you may also specify a range of IP Addresses of the users who can access your content.

Here's some resources on creating signed URLs for popular hosting providers:

Create a File with URLs

If your data is hosted in the cloud (e.g. Amazon S3), you can point Labelbox to your data by creating a JSON file or a CSV file with URLs to each file.

Creating a JSON file (Recommended)

Create a JSON file containing the data URLs. For example, here is a JSON snippet for importing data hosted in Google Storage: Download an example JSON file here.

[
  {
    "externalId": "ab65d5e99w13",
    "imageUrl": "https://storage.googleapis.com/labelbox-example-datasets/tesla/104836109-p100d-review-5.1910x1000.jpeg"
  },
  {
    "externalId": "ljk6s544a7f8",
    "imageUrl": "https://storage.googleapis.com/labelbox-example-datasets/tesla/2017-Tesla-Model-3-top-view.jpg"
  }
]

Creating a CSV File

The first column is the URL and the second column is the External ID (Optional). Example CSV file containing image URLs.

Data_URLs,External_ID
http://res.cloudinary.com/ddpai9fpa/image/upload/v1516660804/isu8zqke6xoopnemuvvc.jpg,ID1
http://res.cloudinary.com/ddpai9fpa/image/upload/v1516660805/ldie4gmhaqfhw1df1wls.jpg,ID2
http://res.cloudinary.com/ddpai9fpa/image/upload/v1516660805/dvbb5kv3dudxhibqpuni.jpg,ID3
http://res.cloudinary.com/ddpai9fpa/image/upload/v1516660806/inm7ipr8h9ecx1fzcspm.jpg,ID4

Upload The JSON or CSV File

After selecting the file to upload, you must choose the column to be labeled. You may also choose an external ID field (optional) which will be included in the data export once labeling is complete.