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

# POST /describe

`POST /describe`

This operation generates a description of an image in human readable language with complete sentences. The description is based on a collection of content tags, which are also returned by the operation. More than one description can be generated for each image. Descriptions are ordered by their confidence score. Descriptions may include results from celebrity and landmark domain models, if applicable.
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

- `maxCandidates` integer
- `language` 'en' | 'es' | 'ja' | 'pt' | 'zh'
- `descriptionExclude` string[]

## Request body

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

## Response `200`

Image description object.

- ImageDescription, nullable — A collection of content tags, along with a list of captions sorted by confidence level, and image metadata.
  - `description` ImageDescriptionDetails, nullable — A collection of content tags, along with a list of captions sorted by confidence level, and image metadata.
    - `captions` ImageCaption[], nullable — A list of captions, sorted by confidence level.
      - `confidence` number, double — The level of confidence the service has in the caption.
      - `text` string, nullable — The text of the caption.
    - `tags` string[], nullable — A collection of image tags.
  - `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.

## 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)