Audio annotation - JSON

  • Updated On Mar 11, 2025
  • Published on Sep 19, 2022
Prev Next

Overview

Dataloop's Audio transcription studio allows creating and editing audio transcription. The annotations JSON format is similar to Video annotation, where annotations also span across time, but simpler, since there are no annotation coordinates.

JSON output format

{
  "annotations": [
    {
  "id": "67ac977faeb79b24172c7457",
  "datasetId": "64b4d464bdf1fccfe1ba5790",
  "url": "https://gate.dataloop.ai/api/v1/items/67ac977faeb79b24172c7457",
  "dataset": "https://gate.dataloop.ai/api/v1/datasets/64b4d464bdf1fccfe1ba5790",
  "createdAt": "2025-02-12T12:43:43.549Z",
  "dir": "/",
  "filename": "/file_example_MP3_1MG.mp3",
  "type": "file",
  "hidden": false,
  "metadata": {
    "system": {
      "encoding": "7bit",
      "isBinary": true,
      "mimetype": "audio/mpeg",
      "originalname": "file_example_MP3_1MG.mp3",
      "refs": [],
      "size": 1059386,
      "taskStatusLog": []
    }
  },
  "name": "file_example_MP3_1MG.mp3",
  "creator": "user@gmail.com",
  "updatedAt": "2025-02-12T12:43:43.642Z",
  "updatedBy": "user@gmail.com",
  "stream": "https://gate.dataloop.ai/api/v1/items/67ac977faeb79b24172c7457/stream",
  "thumbnail": "https://gate.dataloop.ai/api/v1/items/67ac977faeb79b24172c7457/thumbnail",
  "annotations": [
    {
      "id": "67cee4399b0de1e2d0d6ec3b",
      "datasetId": "64b4d464bdf1fccfe1ba5790",
      "itemId": "67ac977faeb79b24172c7457",
      "url": "https://gate.dataloop.ai/api/v1/annotations/67cee4399b0de1e2d0d6ec3b",
      "item": "https://gate.dataloop.ai/api/v1/items/67ac977faeb79b24172c7457",
      "dataset": "https://gate.dataloop.ai/api/v1/datasets/64b4d464bdf1fccfe1ba5790",
      "type": "subtitle",
      "label": "sentence-1",
      "attributes": [],
      "coordinates": {
        "text": "Hello! How is the weather?"
      },
      "metadata": {
        "system": {
          "attributes": {
            "1": "Yes"
          },
          "automated": false,
          "clientId": "4f21b93a-7be8-469c-9294-672d0da6057c",
          "endFrame": 1,
          "endTime": 11.466,
          "frame": 0,
          "isOnlyLocal": false,
          "isOpen": false,
          "itemLinks": [],
          "objectId": "1",
          "openAnnotationVersion": "1.91.1-prod.3",
          "recipeId": "6569aa2b27d7bdd0605b8fc9",
          "snapshots_": [],
          "startTime": 4.224,
          "system": false
        },
        "user": {}
      },
      "creator": "user1@dataloop.ai",
      "createdAt": "2025-03-10T13:08:09.935Z",
      "updatedBy": "user1@dataloop.ai",
      "updatedAt": "2025-03-10T13:11:47.479Z",
      "hash": "f980c431726214904340fcb3378c1f396c11cacd",
      "source": "ui"
    }
  ],
  "annotationsCount": 1,
  "annotated": true
  }
  ]
}

Dictionary Table

Key Name Definition Parent Key
annotations List of annotations Root
id Unique identifier for the item annotations
datasetId Unique identifier for the dataset annotations
url URL to access the item annotations
dataset URL to access the dataset annotations
createdAt Timestamp when the item was created annotations
dir Directory path of the item annotations
filename Name of the file annotations
type Type of the item (e.g., file) annotations
hidden Boolean indicating if the item is hidden annotations
metadata Metadata associated with the item annotations
metadata.system System-level metadata metadata
encoding Encoding type of the file metadata.system
isBinary Boolean indicating if the file is binary metadata.system
mimetype MIME type of the file metadata.system
originalname Original name of the file metadata.system
refs List of reference items metadata.system
size Size of the file in bytes metadata.system
taskStatusLog Log of task statuses metadata.system
name Name of the item annotations
creator Creator of the item annotations
updatedAt Timestamp when the item was last updated annotations
updatedBy User who last updated the item annotations
stream URL to stream the audio annotations
thumbnail URL to the thumbnail image annotations
annotations List of annotations for the item annotations
annotations.id Unique identifier for the annotation annotations[]
annotations.datasetId Dataset ID associated with the annotation annotations[]
annotations.itemId Item ID the annotation belongs to annotations[]
annotations.url URL to access the annotation annotations[]
annotations.item URL to the annotated item annotations[]
annotations.dataset URL to the dataset of the annotation annotations[]
annotations.type Type of annotation (e.g., subtitle) annotations[]
annotations.label Label of the annotation annotations[]
annotations.attributes List of attributes associated with the annotation annotations[]
coordinates Coordinates for the annotation (e.g., text) annotations[]
coordinates.text Annotated text content coordinates
annotations.metadata Metadata related to the annotation annotations[]
metadata.system System-related metadata for the annotation annotations.metadata
attributes Attributes related to the annotation metadata.system
automated Boolean indicating if the annotation was generated automatically metadata.system
clientId Client identifier metadata.system
endFrame End frame of the annotation metadata.system
endTime End time of the annotation (in seconds) metadata.system
frame Frame number of the annotation metadata.system
isOnlyLocal Boolean indicating if the annotation is local metadata.system
isOpen Boolean indicating if the annotation is open metadata.system
itemLinks List of linked items metadata.system
objectId Object ID associated with the annotation metadata.system
openAnnotationVersion Version of the annotation tool metadata.system
recipeId Recipe ID used for annotation metadata.system
snapshots_ Snapshots related to the annotation metadata.system
startTime Start time of the annotation (in seconds) metadata.system
system Boolean indicating if it's a system annotation metadata.system
user User-related metadata metadata
creator User who created the annotation annotations[]
createdAt Timestamp when the annotation was created annotations[]
updatedBy User who last updated the annotation annotations[]
updatedAt Timestamp when the annotation was last updated annotations[]
hash Hash value associated with the annotation annotations[]
source Source of the annotation (e.g., UI) annotations[]
annotationsCount Total count of annotations annotations
annotated Boolean indicating if the item is annotated annotations