How to create jobs with pre-labeled data?

You can import your model predictions (or annotations created outside of GT Studio) and load them as editable annotations on a Job in GT Create. This can improve the labeling speed and reduce manual labeling effort.

Setup Annotation Specification

• Add all the classes that are present in your annotation data.

• Build Name should match the annotation label in your pre-labeled data. If the build name is difficult to understand, you can set a differentDisplay Nameto keep it simple for the annotators.

Upload Pre-annotated jobs

• Once you have set up the annotation specification, you can upload pre-labeled jobs to any workflow. If you have not created a workflow yet, please refer: Set up a Workflow

• The annotation data needs to converted to GT Studio data format. You can refer to the data structure for the annotation data for the required base type and annotation type 👉

Job Build Structure

• You can then put the job build with annotation data in the Data parameter of the Job Creation API defined below.

Create a job

POST https://api.playment.io/v1/projects/:project_id/jobs

This endpoint allows you to create a job

Path Parameters

Name	Type	Description
project_id	string	ID of the project in which you want to create the job

Headers

Name	Type	Description
x-api-key	string	API key for authentication. You can get it from the Settings section in GT Manage

Request Body

Name	Type	Description
data	string	The data object contains the URLs for the images and the annotation data (if any).
batch_id	string	A batch is a way to organize multiple jobs under one batch_id. You can create new batches from the dashboard or by using the batch creation API. If batch_id is left empty or the key is not present, the job is created in the Default batch in your project.
tag	string	A tag is a custom identifier that decides which workflow to route a job into.
reference_id	string	The unique identifier of the job

200 Job successfully created

{
  "data": {
    "job_id": "3f3e8675-ca69-46d7-aa34-96f90fcbb732",
    "reference_id": "001",
    "tag": "draw_bounding_boxes"
  },
  "success": true
}

400

{
    "error": {
        "code": "FS_0003",
        "message": "Invalid data passed",
        "errors": [
            {
                "validation_code": "MANDATORY_FIELD_EMPTY",
                "meta_data": {
                    "fields": [
                        "sensor_data"
                    ]
                }
            }
        ]
    },
    "success": false
}

404 Could not find a cake matching this query.

{    "message": "Ain't no cake like that."}

Example Job Body

{
  "reference_id": "open_dataset_01",
  "tag": "Maker-1",
  "data": {
    "image_url": "https://playment-data-uploads.s3.ap-south-1.amazonaws.com/clients/cde4d0fb-63c3-43f0-bb46-a11ebc6d4455/projects/ba046da4-cac2-4a18-a145-cca115ce1bc7/batch_upload_data/ec6fc997-6101-49dc-bf12-4175371c5c18/test_images_folder/test_image2.png",
    "maker_response": {
      "rectangles": {
        "type": "rectangles",
        "data": [
          {
            "_id": "4228b62d-5a06-4024-ab4b-6aa1577dba27",
            "color": "rgb(70, 26, 158)",
            "state": "editable",
            "attributes": {
              "State": {
                "state": "editable",
                "value": "Moving"
              }
            },
            "label": "Vehicle_car",
            "coordinates": [
              {
                "x": 0.454155,
                "y": 0.507503
              },
              {
                "x": 0.623262,
                "y": 0.507503
              },
              {
                "x": 0.623262,
                "y": 0.626097
              },
              {
                "x": 0.454155,
                "y": 0.626097
              }
            ]
          },
          {
            "_id": "9db456d1-ce0f-4234-9042-c1ff24df4e6f",
            "color": "rgb(70, 26, 158)",
            "state": "editable",
            "attributes": {
              "State": {
                "state": "editable",
                "value": "Moving"
              }
            },
            "label": "Vehicle_car",
            "coordinates": [
              {
                "x": 0.712208,
                "y": 0.494326
              },
              {
                "x": 0.927435,
                "y": 0.494326
              },
              {
                "x": 0.927435,
                "y": 0.653915
              },
              {
                "x": 0.712208,
                "y": 0.653915
              }
            ]
          },
          {
            "_id": "d65dc5ef-0527-4907-a89b-cfd159b8d66a",
            "color": "rgb(70, 26, 158)",
            "state": "editable",
            "attributes": {
              "State": {
                "state": "editable",
                "value": "Moving"
              }
            },
            "label": "Vehicle_car",
            "coordinates": [
              {
                "x": 0.270773,
                "y": 0.516287
              },
              {
                "x": 0.321285,
                "y": 0.516287
              },
              {
                "x": 0.321285,
                "y": 0.560211
              },
              {
                "x": 0.270773,
                "y": 0.560211
              }
            ]
          },
          {
            "_id": "1a9d664b-9d31-490e-baa2-ca275627dfbc",
            "color": "rgb(70, 26, 158)",
            "state": "editable",
            "attributes": {
              "State": {
                "state": "editable",
                "value": "Moving"
              }
            },
            "label": "Vehicle_car",
            "coordinates": [
              {
                "x": 0.343247,
                "y": 0.522144
              },
              {
                "x": 0.380582,
                "y": 0.522144
              },
              {
                "x": 0.380582,
                "y": 0.56314
              },
              {
                "x": 0.343247,
                "y": 0.56314
              }
            ]
          }
        ]
      }
    }
  }
}

Editing Annotation in GT Create

After creating jobs with Annotated data, you can edit the annotations to refine the model predictions in GT Create.

To learn more about all the features in GT Create, refer:

Tools for Labelling