---
title: AI Image Face Detection API
slug: detect-human-faces
url: https://apyverse.com/apyhub/service/detect-human-faces
provider: ApyHub
categories: [Artificial Intelligence, Image Processing]
tags: [face-detection, computer-vision, image-analysis, object-detection, facial-recognition]
auth: api_key
---

# AI Image Face Detection API

Detect human faces from an image URL or file upload. Returns provider-specific vision output under data.apyhub, data.azure, or data.google.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `ai/image/detect/face/url` | What it does Detects human faces from an image URL. You send the image url plus optional service cr… | 500 |
| POST | `ai/image/detect/face/file` | What it does Detects human faces from an uploaded file and returns a JSON object with face-detectio… | 500 |

## About

## What it does
Face Detection finds human faces in an image and returns the detector response from the service you choose. Send either an image URL or a binary file, and choose `requested_service` as `apyhub`, `azure`, or `google` when you need a specific vision backend.

Use the `/url` endpoint when the image is already hosted online. Include `body.url`, and optionally supply Azure credentials in `body.azure` or Google credentials in `body.google` if you want to route the request through those providers. Use `/file` when you want to upload an image directly; it accepts `body.file` and optional Azure fields such as `azure_key`, `azure_region`, `azure_endpoint`, `azure_account_id`, and `azure_access_token`, plus `google_key` if needed.

The response is grouped under `data` and includes one of three provider objects: `data.apyhub`, `data.azure`, or `data.google`. That makes it easy to plug Face Detection into moderation flows, identity-related prechecks, photo organization, or any pipeline that needs to know whether a face is present before taking the next step.

Use this when you need face detection as a lightweight image-analysis step without building or maintaining your own vision stack.

## Usage

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