Edit

Image tagging (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 is not 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 context of a known setting.

Try out the image tagging features quickly and easily in your browser using 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.

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.

Next steps