Audio annotation - JSON

Updated On 11 Mar 2025

Print
Dark
Light
PDF

Article summary

Did you find this summary helpful?

Thank you for your feedback

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

What's Next

GIS studio

Table Of Contents

Overview
JSON output format
Dictionary Table