Table of Contents
Asset metadata via JSON
This document describes how to format your JSON file to include additional asset information (asset metadata) when importing your data. Attach additional information by including a URL to an image file, a URL to a video file, or a string of text when you create your import file.
To see the basic JSON format without additional asset information, see Importing via JSON.
Attach metadata to video or image imports
Reasons to attach an image to an asset:
- The asset is part of a larger image and labelers may need to see the larger image for context.
- Labelers need a an image to reference to help them label correctly.
Attach a video to the asset to give context for the images being labeled.
Attach text to an asset to provide context, instructions or guidance to the labeler.
To specify additional asset information, include the following fields under info in your JSON import file.
info key per row. However, you can add additional pieces of metadata via the GraphQL API.
| The media type attached to your asset. Value will be |
| Paths to external URLs to render on the web page as a video or image embed. Text strings that are not paths will be rendered as text. |
The example below will import three image assets with an image, a video, or text attached to each asset.
[
{
"externalId": "2017-Tesla-Model-S-P90D-102.jpg",
"imageUrl": "https://storage.googleapis.com/labelbox-example-datasets/tesla/2017-Tesla-Model-S-P90D-102.jpg",
"info": {
"type": "IMAGE",
"value": "https://storage.googleapis.com/labelbox-example-datasets/tesla/2017-Tesla-Model-S-P90D-102.jpg"
}
},
{
"externalId": "2017-Tesla-Model-3-top-view.jpg",
"imageUrl": "https://storage.googleapis.com/labelbox-example-datasets/tesla/2017-Tesla-Model-3-top-view.jpg",
"info": {
"type": "VIDEO",
"value": "http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4"
}
},
{
"externalId": "2016-tesla-model-s-17-of-43.jpg",
"imageUrl": "https://storage.googleapis.com/labelbox-example-datasets/tesla/2016-tesla-model-s-17-of-43.jpg",
"info": {
"type": "TEXT",
"value": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."
}
}
]
Attach metadata to text imports
The example below will import one text asset with an image attached.
[
{
"data": "Lorem ipsum dolor sit amet..." ,
"info": {
"type": "IMAGE",
"value": "https://storage.googleapis.com/labelbox-example-datasets/tesla/2016-tesla-model-s-17-of-43.jpg"
}
}
]
Import your JSON file
To learn how to import your JSON file, see Import your JSON file.
View the asset metadata
You can view an asset’s additional information by clicking the tab icon in the top left corner when the asset is loaded in the labeling interface.
