---
title: AI Video Face Detection API
slug: face-detection
url: https://apyhub.com/apyhub/service/face-detection
provider: ApyHub
categories: [Artificial Intelligence, Image Processing]
auth: api_key
---

# AI Video Face Detection API

Detect faces from uploaded files or remote URLs using Azure or Google. Returns provider-specific results in a data object for media workflows.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/ai/video/detect/face/file` | What it does Detects faces from an uploaded file and routes the request to either Azure or Google b… | 500 |
| POST | `/ai/video/detect/face/url` | What it does Detects faces in a media file fetched from a URL. You send the media URL and choose wh… | 500 |

## About

## What it does
Face Detection lets you send an image or video URL and get face-detection results back from either Azure or Google, depending on the provider you select.

Use the `/file` endpoint to upload a file, or the `/url` endpoint to point the service at a remote asset. In both cases, the request requires `requested_service`, which must be `azure` or `google`. The file-based route also accepts `azure_region`, `azure_account_id`, `azure_access_token`, and `google_credential_file` where relevant. The URL route accepts a `url`, plus provider-specific fields under `azure` or `google`, including Google credential JSON when you are using the Google route.

The response wraps results under `data`, with either an `azure` object or a `google` object present depending on the selected service. That makes it straightforward to plug Face Detection into moderation flows, media indexing, or any workflow that needs to detect faces before you store, route, or analyse visual content.

If you are building an app that handles user uploads or remote media links, Face Detection gives you a simple way to separate the transport layer from the detection provider while keeping the contract clear on both sides.

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

## Usage

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