---
title: AI Image Face Detection API
slug: detect-human-faces
url: https://apyhub.com/apyhub/service/detect-human-faces
provider: ApyHub
tags: [face-detection, computer-vision, image-analysis, portrait-detection, image-classification]
auth: api_key
---

# AI Image Face Detection API

What it does Face Detection identifies human faces in an image you send as a file or by URL. Use it when you need to flag portrait photos, pre-check user uploads, or build image workflows that depend on knowing whether a face is present. Send a binary file to /file, or pass an image URL to /url. Bo…

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/ai/image/detect/face/file` | What it does Uploads an image file and runs human face detection against the selected provider. The… | 500 |
| POST | `/ai/image/detect/face/url` | What it does Detects human faces from an image URL. You send the image url and optionally choose wh… | 500 |

## About

## What it does
Face Detection identifies human faces in an image you send as a file or by URL. Use it when you need to flag portrait photos, pre-check user uploads, or build image workflows that depend on knowing whether a face is present.

Send a binary file to `/file`, or pass an image URL to `/url`. Both endpoints accept a `requested_service` value of `azure`, `google`, or `apyhub`, so you can route the request to the vision provider you want. The file endpoint also supports provider-specific credentials such as `azure_key`, `azure_region`, `azure_endpoint`, `azure_account_id`, `azure_access_token`, and `google_key`. The URL endpoint accepts nested `azure` and `google` credential objects for the same kind of provider configuration.

The response is returned under a `data` object with separate provider results for `azure`, `apyhub`, and `google`. That makes it easy to compare outputs or standardise your own downstream handling without changing the input format.

Use Face Detection for moderation checks, profile-photo validation, photo indexing, or any feature where your app needs a face-aware image signal before moving to the next step. 

| Provider (requested_service) | Atoms |
|------------------------------|------:|
| Azure                        |   500 |
| Google                       |  500 |
| ApyHub                       |  2000 |

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/apyhub/service/detect-human-faces