---
title: "Analyze an image using AI"
method: POST
path: "/api/ai/images/v2/image-analysis"
tags: ["AI Services"]
---

# Analyze an image using AI

`POST /api/ai/images/v2/image-analysis`

Analyse an Image using AI. This endpoint helps to identify the different objects in the image, classify them and assign them under different aliases. It also analyses the Colour combinations of the different objects, describes the activities and the dominant colours in the image.

## Response `200`

OK

- object
  - `code` integer — The HTTP status code.
  - `status` string — Status indicating the success of the response.
  - `data` object — The response data.
    - `analysed_data` array[] — Analyzed data.
      - unknown[]
        - unknown
    - `quality` object — Quality information.
      - `brightness` number — Brightness value.
      - `contrast` number — Contrast value.
      - `sharpness` number — Sharpness value.
    - `foreground` object — Foreground information.
      - `dominant_colors` string[] — Dominant colors in the foreground.
      - `quality` unknown[]
        - unknown
    - `background` object — Background information.
      - `dominant_colors` string[] — Dominant colors in the background.
      - `quality` unknown[]
        - unknown
    - `primary_colours` array[] — Primary colors.
      - unknown[]
        - unknown
  - `processing_time` integer — The time taken to process the request, in milliseconds.
  - `processing_id` string — A universally unique identifier for the request. This can be used to track the request in the logs.
  - `processing_count` integer — The number of times the request has been processed.

## Other responses

- `400` — Bad Request. This mostly happens because of invalid image sizes. Neither `height` nor `width` of the image should be less than 128px. Only one of the sides of the image should be greater than or equal to 512px. (Eg: 512x512, 512x768, 768x512) Maximum dimensions supported is 512x896.
- `401` — Unauthorized
- `404` — Not Found
- `406` — Not Acceptable
- `500` — Internal Server Error

---

[API](https://skmtc.net/worqhat/apis/worqhat-ai-api-endpoints-2.md) · [All operations](https://skmtc.net/worqhat/apis/worqhat-ai-api-endpoints-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/worqhat/worqhat-ai-api-endpoints-2/versions/fc369f69a3e6/schema)