---
title: "Perform image analysis and identify objects in an image"
method: POST
path: "/api/ai/images/v2/image-analysis"
---

# Perform image analysis and identify objects in an image

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

## Request

- Base URL: `https://api.worqhat.com`
- URL: `https://api.worqhat.com/api/ai/images/v2/image-analysis`
- Auth: API key in header `x-api-key` and API key in header `x-org-key`
- TypeScript: <https://skmtc.dev/worqhat/apis/worqhat-ai-api-endpoints/docs/api/ai/images/v2/image-analysis/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body `multipart/form-data`

- object
  - `image` string, binary

## Response `200`

Success

- ImageAnalysisResponse
  - `id` string
  - `status` string
  - `timestamp` integer
  - `content` AnalysisResult[]
    - `name` string
    - `confidence` number
    - `instances` object[]
    - `parents` string[]
    - `aliases` string[]
    - `categories` string[]
  - `processing_count` integer

## Other responses

- `400`: Bad Request
- `401`: Unauthorized - Invalid API Key or Organization Key
- `404`: Not Found
- `406`: Not Acceptable - Invalid Content Type or Content not supported
- `500`: Internal Server Error

## Changes

- **2023-06-27** `ecd19b0ebd32`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/worqhat/apis/worqhat-ai-api-endpoints/changes/api/ai/images/v2/image-analysis/post.md)

---

[API](https://skmtc.dev/worqhat/apis/worqhat-ai-api-endpoints.md) - [All operations](https://skmtc.dev/worqhat/apis/worqhat-ai-api-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/worqhat/apis/worqhat-ai-api-endpoints/revisions/a1044e79bd85?raw)