v47

OpenAPI 3.0.2raw.githubusercontent.com2026-08-01360485.4 KB

Files

Face Detection

Detect faces in an image or video.

Use this API to get the list of faces detected in the image or video to use in the face swap photo or face swap video API calls for multi-face swaps.

Note: Face detection is free to use for the near future. Pricing may change in the future.

post/v1/face-detection

confidence_scorenumber

Confidence threshold for filtering detected faces.

Higher values (e.g., 0.9) include only faces detected with high certainty, reducing false positives.
Lower values (e.g., 0.3) include more faces, but may increase the chance of incorrect detections.

{
  "confidence_score": 0.5,
  "assets": {
    "target_file_path": "api-assets/id/1234.png"
  }
}

200

idstring required

The id of the task. Use this value in the get face detection details API to get the details of the face detection task.

credits_chargedinteger required

The credits charged for the task.

{
  "id": "uuid-example"
}