---
title: Face Detection
slug: video-detect-faces
url: https://apyverse.com/apyhub/service/video-detect-faces
provider: ApyHub
categories: [Artificial Intelligence, Image Processing]
auth: api_key
---

# Face Detection

Detect faces from a URL or file upload using Azure or Google. Returns provider-specific results in a simple data wrapper for media workflows.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `ai/video/detect/face/url` | What it does Detects faces from an image or video URL and returns a JSON object with a data object.… | 500 |
| POST | `ai/video/detect/face/file` | What it does Uploads a file and runs face detection using the requested provider route. The respons… | 500 |

## About

## What it does
Face Detection analyzes an image or video from a URL or uploaded file and returns detection results for the service you choose. Send the media, pick `requested_service` as `azure` or `google`, and get back the provider-specific response under `data.azure` or `data.google`.

Use the `/url` route when your media is already hosted, or `/file` when you need to upload it directly. The URL route accepts `url` plus optional provider credentials: `azure.region`, `azure.account_id`, `azure.access_token`, or `google.google_language` and `google.google_credential_json`. The file route accepts `file` plus `azure_region`, `azure_account_id`, `azure_access_token`, or `google_credential_file` for Google routes.

Face Detection is a good fit for moderation, content tagging, and media workflows that need to identify faces before downstream processing. The response is wrapped in a single `data` object, with the chosen provider's result nested inside it. No extra fields are exposed beyond the provider output.

If you already have an Azure or Google vision setup, this service gives you a consistent entry point for either source format while keeping the response shape simple.

## Usage

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