---
title: "Describe"
method: POST
path: "/describe"
tags: ["vision"]
---

# Describe

`POST /describe`

Describe an image.

Supported image formats include JPEG, PNG, and WebP.

## Response `200`

Description(s) created successfully.

- DescribeResponse — The response for a describe request encapsulates a list of descriptions.
  - `descriptions` Description[] — A collection of descriptions for given content.
    - `text` string — The generated description for the provided image.

## Other responses

- `400` — Invalid input provided.
- `422` — Image failed the safety check.
- `429` — Too many requests.

---

[API](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ideogram/ideogram-openapi-3-0/revisions/bd40f367a834/schema)