---
title: "Modify Image V2"
method: POST
path: "/api/ai/images/v2/face-detection"
---

# Modify Image V2

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

## Response `200`

Success

- FaceDetectionResponse
  - `id` string — The unique identifier associated with the face detection process.
  - `status` string — The status of the face detection process.
  - `timestamp` integer — The timestamp when the face detection request was processed.
  - `analysed_data` FaceData[] — The analyzed data of the detected faces in the image.
    - `bounding_box` object
      - `width` number — The width of the face bounding box as a fraction of the overall image width.
      - `height` number — The height of the face bounding box as a fraction of the overall image height.
      - `left` number — The left coordinate of the face bounding box as a fraction of the overall image width.
      - `top` number — The top coordinate of the face bounding box as a fraction of the overall image height.
    - `age_range` object
      - `low` integer — The estimated lower age of the detected person.
      - `high` integer — The estimated upper age of the detected person.
    - `smile` object
      - `value` boolean — Indicates whether the person is smiling or not.
      - `confidence` number — The confidence score of the smile detection.
    - `eyeglasses` object
      - `value` boolean — Indicates whether the person is wearing eyeglasses or not.
      - `confidence` number — The confidence score of the eyeglasses detection.
    - `sunglasses` object
      - `value` boolean — Indicates whether the person is wearing sunglasses or not.
      - `confidence` number — The confidence score of the sunglasses detection.
    - `gender` object
      - `value` string — The gender of the detected person.
      - `confidence` number — The confidence score of the gender detection.
    - `beard` object
      - `value` boolean — Indicates whether the person has a beard or not.
      - `confidence` number — The confidence score of the beard detection.
    - `mustache` object
      - `value` boolean — Indicates whether the person has a mustache or not.
      - `confidence` number — The confidence score of the mustache detection.
    - `eyes_open` object
      - `value` boolean — Indicates whether the person's eyes are open or not.
      - `confidence` number — The confidence score of the eyes open detection.
    - `mouth_open` object
      - `value` boolean — Indicates whether the person's mouth is open or not.
      - `confidence` number — The confidence score of the mouth open detection.
    - `emotions` Emotion[] — The detected emotions and their confidence scores.
      - `type` string — The type of emotion detected.
      - `confidence` number — The confidence score of the emotion detection.
    - `landmarks` Landmark[] — The facial landmarks and their positions on the face.
      - `type` string — The type of facial landmark.
      - `x` number — The x-coordinate of the facial landmark as a fraction of the overall image width.
      - `y` number — The y-coordinate of the facial landmark as a fraction of the overall image height.
    - `pose` object
      - `roll` number — The roll angle of the detected face. Positive values indicate clockwise rotation, while negative values indicate counterclockwise rotation. The roll angle represents the amount of rotation around the vertical axis passing through the center of the face.
      - `yaw` number — The yaw angle of the detected face. Positive values indicate the face turning right, while negative values indicate the face turning left. The yaw angle represents the amount of rotation around the vertical axis passing through the neck.
      - `pitch` number — The pitch angle of the detected face. Positive values indicate the face tilting upwards, while negative values indicate the face tilting downwards. The pitch angle represents the amount of rotation around the horizontal axis passing through the center of the face.
    - `quality` object
      - `brightness` number — The brightness score of the detected face.
      - `sharpness` number — The sharpness score of the detected face.
    - `confidence` number — The confidence score of the face detection.
  - `processing_count` integer — The number of times the image has been processed for face detection.

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

---

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