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