---
title: "POST /tag"
method: POST
path: "/tag"
---

# POST /tag

`POST /tag`

This operation generates a list of words, or tags, that are relevant to the content of the supplied image. The Computer Vision API can return tags based on objects, living beings, scenery or actions found in images. Unlike categories, tags are not organized according to a hierarchical classification system, but correspond to image content. Tags may contain hints to avoid ambiguity or provide context, for example the tag "ascomycete" may be accompanied by the hint "fungus".
Two input methods are supported -- (1) Uploading an image or (2) specifying an image URL.
A successful response will be returned in JSON. If the request failed, the response will contain an error code and a message to help understand what went wrong.

## Query parameters

- `language` 'en' | 'es' | 'ja' | 'pt' | 'zh'

## Request body

- ImageUrl
  - `url` string, required — Publicly reachable URL of an image.

## Response `200`

Image tags object.

- TagResult, nullable — The results of a image tag operation, including any tags and image metadata.
  - `metadata` ImageMetadata, nullable — Image metadata.
    - `format` string, nullable — Image format.
    - `height` integer — Image height, in pixels.
    - `width` integer — Image width, in pixels.
  - `requestId` string, nullable — Id of the REST API request.
  - `tags` ImageTag[], nullable — A list of tags with confidence level.
    - `confidence` number, double — The level of confidence that the entity was observed.
    - `hint` string, nullable — Optional hint/details for this tag.
    - `name` string, nullable — Name of the entity.

## Other responses

- `default` — Error response.

---

[API](https://skmtc.net/azure/apis/cognitiveservices-computervision.md) · [All operations](https://skmtc.net/azure/apis/cognitiveservices-computervision/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/cognitiveservices-computervision/versions/c35eebd9bcbe/schema)