Instance Segmentation - JSON

Overview

This page describes Instance Segmentation Annotation JSON, a data format for describing Instance Segmentation Annotation data in JavaScript Object Notation (JSON).

For more information, see the Instance Segmentation Studio.

This JSON code includes the entity's data related to our software and its metadata.

JSON Output

JSON structure for Dataloop's instance segmentation output, detailing image metadata and binary mask annotations per labeled object instance.

{
  "id": "684bf33d752e9d0303efd93f",                         // Unique ID of the item (image file in this case)
  "datasetId": "6841b51c7b3d926c396f3564",                 // ID of the dataset this item belongs to
  "url": "https://rc-gate.dataloop.ai/api/v1/items/684bf33d752e9d0303efd93f", // API endpoint to access the item
  "dataset": "https://rc-gate.dataloop.ai/api/v1/datasets/6841b51c7b3d926c396f3564", // API endpoint to access the dataset
  "createdAt": "2025-06-13T09:45:33.498Z",                 // Timestamp of when the item was created
  "dir": "/",                                              // Directory path within the dataset
  "filename": "/flamingos.jpg",                            // File name of the image
  "type": "file",                                          // Type of item; typically 'file' for images/videos
  "hidden": false,                                         // Visibility flag; false means the item is visible
  "metadata": {
    "system": {
      "channels": 3,                                       // Number of color channels (RGB = 3)
      "encoding": "7bit",                                  // Encoding type used
      "height": 3264,                                      // Image height in pixels
      "isBinary": true,                                    // Indicates if file is binary (true for images)
      "mimetype": "image/jpeg",                            // MIME type of the file
      "originalname": "flamingos.jpg",                     // Original file name at upload
      "refs": [],                                          // References to other linked items (empty here)
      "size": 1131814,                                     // File size in bytes
      "taskStatusLog": [],                                 // Logs for task progress or history (empty here)
      "thumbnailId": "684bf34031f24f94aad41ae4",           // ID for the thumbnail image
      "width": 4896                                        // Image width in pixels
    }
  },
  "name": "flamingos.jpg",                                 // Name of the item
  "creator": "user@dataloop.ai",                           // User who created/uploaded the item
  "updatedAt": "2025-06-13T09:45:36.502Z",                 // Last update timestamp
  "updatedBy": "user@dataloop.ai",                         // User who last updated the item
  "stream": "https://rc-gate.dataloop.ai/api/v1/items/684bf33d752e9d0303efd93f/stream", // Stream endpoint for real-time access
  "thumbnail": "https://rc-gate.dataloop.ai/api/v1/items/684bf33d752e9d0303efd93f/thumbnail", // URL for thumbnail image
  "annotations": [                                         // List of annotation objects (instance segmentations)
    {
      "id": "684f17a0622c2414603624df",                    // Unique annotation ID
      "datasetId": "6841b51c7b3d926c396f3564",             // Dataset ID the annotation belongs to
      "itemId": "684bf33d752e9d0303efd93f",                // Item ID the annotation is linked to
      "url": "https://rc-gate.dataloop.ai/api/v1/annotations/684f17a0622c2414603624df", // API endpoint to access annotation
      "item": "https://rc-gate.dataloop.ai/api/v1/items/684bf33d752e9d0303efd93f", // API link to the item
      "dataset": "https://rc-gate.dataloop.ai/api/v1/datasets/6841b51c7b3d926c396f3564", // API link to the dataset
      "type": "binary",                                   // Type of annotation; 'binary' means binary mask
      "label": "label-3",                                 // Label/class name for the instance
      "attributes": [],                                   // List of additional attributes (if any)
      "coordinates": "data:image/png;base64,...",         // Encoded binary mask image in base64 PNG format
      "metadata": {
        "system": {
          "attributes": {},                               // Optional metadata attributes
          "automated": false,                             // Whether it was created by an automated tool
          "clientId": "f62b314a-8f3c-487c-b700-e470ab0cf7ab", // Internal client/job ID
          "endFrame": 1,                                  // End frame (for video; static image = 1)
          "endTime": 0,                                   // End time in seconds (for video)
          "frame": 0,                                     // Frame number (static images = 0)
          "itemLinks": [],                                // Any linked items (not used here)
          "objectId": 1,                                  // Object instance ID (per label)
          "openAnnotationVersion": "1.98.1-rc.41",        // Annotation engine version used
          "recipeId": "6841b51ca7d3513b16db2c0e",          // Annotation recipe/config used
          "snapshots_": [],                               // Annotation snapshots (empty if none)
          "startTime": 0,                                 // Start time in seconds (for video)
          "system": false                                 // Indicates if it is a system-generated field
        },
        "user": {}                                        // Placeholder for user-defined metadata
      },
      "creator": "user@dataloop.ai",                       // User who created this annotation
      "createdAt": "2025-06-15T18:57:36.429Z",             // Timestamp of annotation creation
      "updatedBy": "user@dataloop.ai",                     // User who last updated the annotation
      "updatedAt": "2025-06-15T18:57:36.429Z",             // Timestamp of last update
      "hash": "6841b51c7b3d926c396f3564_684bf33d752e9d0303efd93f_label-3_user@dataloop.ai_1", // Internal hash for annotation identity
      "source": "ui"                                       // Origin of annotation ('ui' = manual via UI)
    },
    {
      // Second annotation object (similar structure as above)
      "id": "684f17a0622c2434863624de",
      "datasetId": "6841b51c7b3d926c396f3564",
      "itemId": "684bf33d752e9d0303efd93f",
      "url": "https://rc-gate.dataloop.ai/api/v1/annotations/684f17a0622c2434863624de",
      "item": "https://rc-gate.dataloop.ai/api/v1/items/684bf33d752e9d0303efd93f",
      "dataset": "https://rc-gate.dataloop.ai/api/v1/datasets/6841b51c7b3d926c396f3564",
      "type": "binary",
      "label": "label-2",
      "attributes": [],
      "coordinates": "data:image/png;base64,...",         // Binary mask encoded as base64 PNG
      "metadata": {
        "system": {
          "attributes": {},
          "automated": false,
          "clientId": "e5d23221-ddbe-4aeb-bb5a-d278a585ad89",
          "endFrame": 1,
          "endTime": 0,
          "frame": 0,
          "itemLinks": [],
          "objectId": 1,
          "openAnnotationVersion": "1.98.1-rc.41",
          "recipeId": "6841b51ca7d3513b16db2c0e",
          "snapshots_": [],
          "startTime": 0,
          "system": false
        },
        "user": {}
      },
      "creator": "user@dataloop.ai",
      "createdAt": "2025-06-15T18:57:36.429Z",
      "updatedBy": "user@dataloop.ai",
      "updatedAt": "2025-06-15T18:57:36.429Z",
      "hash": "6841b51c7b3d926c396f3564_684bf33d752e9d0303efd93f_label-2_user@dataloop.ai_1",
      "source": "ui"
    }
  ],
  "annotationsCount": 2,                                   // Total number of annotations on this item
  "annotated": true                                        // Indicates whether the item has any annotations
}