Edit

Share via

Image tagging with Image Analysis version 4.0

  • Article

Image Analysis can return content tags for thousands of recognizable objects, living beings, scenery, and actions that appear in images. Tagging isn't limited to the main subject, such as a person in the foreground, but also includes the setting (indoor or outdoor), furniture, tools, plants, animals, accessories, gadgets, and so on. Tags aren't organized as a taxonomy and don't have inheritance hierarchies. When tags are ambiguous or not common knowledge, the API response provides hints to clarify the meaning of the tag in the context of a known setting.

Try out the image tagging feature quickly and easily in your browser by using Azure AI Vision Studio.

Try Vision Studio

Image tagging example

The following JSON response illustrates what Azure AI Vision returns when tagging visual features detected in the example image.

Photograph of a blue house and the front yard. 

{
    "metadata":
    {
        "width": 300,
        "height": 200
    },
    "tagsResult":
    {
        "values":
        [
            {
                "name": "grass",
                "confidence": 0.9960499405860901
            },
            {
                "name": "outdoor",
                "confidence": 0.9956876635551453
            },
            {
                "name": "building",
                "confidence": 0.9893627166748047
            },
            {
                "name": "property",
                "confidence": 0.9853052496910095
            },
            {
                "name": "plant",
                "confidence": 0.9791355729103088
            },
            {
                "name": "sky",
                "confidence": 0.976455569267273
            },
            {
                "name": "home",
                "confidence": 0.9732913374900818
            },
            {
                "name": "house",
                "confidence": 0.9726771116256714
            },
            {
                "name": "real estate",
                "confidence": 0.972320556640625
            },
            {
                "name": "yard",
                "confidence": 0.9480281472206116
            },
            {
                "name": "siding",
                "confidence": 0.945357620716095
            },
            {
                "name": "porch",
                "confidence": 0.9410697221755981
            },
            {
                "name": "cottage",
                "confidence": 0.9143695831298828
            },
            {
                "name": "tree",
                "confidence": 0.9111745357513428
            },
            {
                "name": "farmhouse",
                "confidence": 0.8988940119743347
            },
            {
                "name": "window",
                "confidence": 0.894851803779602
            },
            {
                "name": "lawn",
                "confidence": 0.894050121307373
            },
            {
                "name": "backyard",
                "confidence": 0.8931854963302612
            },
            {
                "name": "garden buildings",
                "confidence": 0.8859137296676636
            },
            {
                "name": "roof",
                "confidence": 0.8695330619812012
            },
            {
                "name": "driveway",
                "confidence": 0.8670969009399414
            },
            {
                "name": "land lot",
                "confidence": 0.856428861618042
            },
            {
                "name": "landscaping",
                "confidence": 0.8540748357772827
            }
        ]
    }
}

Use the API

The tagging feature is part of the Analyze Image API. You can call this API using REST. Include Tags in the features query parameter. Then, when you get the full JSON response, parse the string for the contents of the "tags" section.

Related content