---
title: "Identify Faces and Characteristics in an Image"
method: POST
path: "/api/ai/images/v2/face-detection"
tags: ["AI Services"]
---

# Identify Faces and Characteristics in an Image

`POST /api/ai/images/v2/face-detection`

This endpoint is used to identify faces and characteristics in an image. It accepts a Form Data containing the image and returns the the face detection results.

## Response `200`

Successful response

- object
  - `code` integer
  - `status` string
  - `data` object
    - `analysed_data` object[]
      - `age_range` object
        - `high` integer
        - `low` integer
      - `beard` object
        - `confidence` number
        - `value` boolean
      - `bounding_box` object
        - `height` number
        - `left` number
        - `top` number
        - `width` number
      - `confidence` number
      - `emotions` object[]
  - `processing_time` integer
  - `processing_id` string
  - `processing_count` integer

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