Labelling API
The labelling API process images of houses and generates the correct label for both indoor and outdoor images.

Labels

Initially the model outputs whether the picture was taken indoor or outdoor. If not recognized the API will label it as other.
For images taken indoors the model will label the following rooms with the output class mentioned in brackets:
  • Living room [‘living_room’]
  • Kitchen [‘kitchen’]
  • Bathroom [‘bathroom’]
  • Bedroom [‘bedroom’]
  • Other rooms [‘other_room’]
    • Hallway [‘hall_corridor’]
    • Room (empty room) [‘room’]
    • Scullery (bijkeuken) [‘scullery’]
Example indoor JSON response
1
{
2
"Output": {
3
"Image_Class": "indoor",
4
"ConfidencePercent_Image_Class": "100.0",
5
"Room_Class": "bedroom",
6
"ConfidencePercent_Room_Class": "99.22"
7
}
8
}
Copied!
More specifically if an image belongs to the class Other rooms, the model will output also the specific subclass predicted for the image for example:
Image: the API labelled the image to be a hallway indoor, see output code below
1
{
2
"Output": {
3
"Image_Class": "indoor",
4
"ConfidencePercent_Image_Class": "99.9",
5
"Room_Class": "other_room",
6
"ConfidencePercent_Room_Class": "96.18",
7
"Room_Subclass": "hall_corridor",
8
"ConfidencePercent_Room_Subclass": "87.85"
9
}
10
}
Copied!
Outdoor For images taken outdoors the model will label the following scenes:
  • Facade [‘facade’]
  • View [‘view’]
  • Street [‘street’]
  • Balcony/garden [‘balcony-garden’]
  • Building part [‘building_part’]
  • No building [‘no_building’]
Example outdoor response:
1
{
2
"Output": {
3
"Image_Class": "outdoor",
4
"ConfidencePercent_Image_Class": "99.99",
5
"Scene_Class1": "facade",
6
"ConfidencePercent_Scene_Class1": "93.89"
7
}
8
}
Copied!
In case the confidence percent is lower than the threshold of 70.0, the model will output the top two predicted classes. This was developed to cover the cases where an image belongs to more than one class for example to balcony/garden and facade.
Image: the API labelled the image to be outdoor with the image belonging to show a balcony-garden and facade
1
{
2
"Output": {
3
"Image_Class": "outdoor",
4
"ConfidencePercent_Image_Class": "100.0",
5
"Scene_Class1": "balcony-garden",
6
"ConfidencePercent_Scene_Class1": "36.92",
7
"Scene_Class2": "facade",
8
"ConfidencePercent_Scene_Class2": "59.15"
9
}
10
}
Copied!

Post a request

post
https://api.altum.ai
/labelling/img
IMG
post
https://api.altum.ai
/labelling/url
URL