Deepfake

Analyzes a photo to assess whether the input is likely real or synthetically generated (e.g. deepfake). This is a standalone image authenticity check.

The higher the score, the more likely the image is genuine.

Endpoint

POST https://cloud.ooto-ai.com/api/v1.0/deepfake

Request Format

  • Method: POST

  • Content-Type: multipart/form-data

Authentication Headres

To access the API, you need to include the following headers in your request:

  • APP-ID: Your application's unique identifier.

  • APP-KEY: Your application's authentication key.

Form Data

Field

Type

Required

Description

photo

File

Yes

JPEG or PNG image with one visible face

Example Request (cURL)

curl -X POST --location 'https://cloud.ooto-ai.com/api/v1.0/deepfake' \
--header 'APP-ID: put_app_id_here' \
--header 'APP-KEY: put_app_key_here' \
--form 'photo=@"/path/to/photo"'

Replace «app_id», «app_key» with your actual credentials and the path to your selfie image.

Successful Response (HTTP 200)

{
    "transactionId": "6cd34e01-d641-4ace-b2c0-3d548df1beae",
    "result": {
        "deepfake": {
            "score": 0.9772506356239319,
            "fine": true
        },
        "box": {
            "x": 25,
            "y": 275,
            "w": 606,
            "h": 761
        },
        "landmarks": [
            [
                230,
                574
            ],
            [
                457,
                567
            ],
            [
                369,
                740
            ],
            [
                248,
                802
            ],
            [
                444,
                796
            ]
        ]
    }
}

Field Explanation

Field

Description

score

Deepfake confidence score (range: 0.0–1.0) — higher is better

fine

true if score ≥ threshold (e.g. ≥ 0.9)

quality

Image quality of the detected face

box

Face bounding box [x1, y1, x2, y2]

landmarks

Facial keypoints (68-point format)

Error response (HTTP 400)

{
  "transactionId": "efb66e50-4c87-493d-b026-543dacdbe314",
  "result": {
    "status": "error",
    "code": 5,
    "info": "can not detect face"
  }
}

Engine Errors

Code

Info

1

photo should not be empty

2

wrong mime-type in input data

3

photo size is 0 bytes

4

can not decode image, check it is valid jpeg or png file

5

can not detect face

6

more than one face detected on photo

9

can not extract features from sample, probably it is too small

Notes

  • Score close to 1.0 → highly confident that image is real

  • Use with liveness check for enhanced spoof detection

  • Ensure good lighting, resolution, and frontal face for best results

Last updated