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

# Person Detection

Detect people from an uploaded file or media URL. Returns provider-specific results for Azure or Google in `data`.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `ai/video/detect/person/url` | What it does Accepts a media URL and runs person detection using the selected provider. The request… | 500 |
| POST | `ai/video/detect/person/file` | What it does Uploads a file and runs person detection using the requested provider route. The respo… | 500 |

## About

## What it does
Person Detection identifies people in a video or image file and returns the results in a service-specific response under `data.azure` or `data.google`, depending on the `requested_service` you send.

Use `POST /file` when you want to upload a binary file directly. Send `file` and `requested_service`, and include the Azure fields `azure_region`, `azure_account_id`, and `azure_access_token` when using Azure, or `google_credential_file` when using Google. Use `POST /url` when the media is already hosted online; send `url` plus `requested_service`, and add the matching Azure or Google credential object as needed.

Person Detection fits workflows that need to detect people in uploaded media before further processing, such as content moderation, media indexing, or downstream computer-vision analysis. The API does not invent extra metadata in the schema: it returns the provider-specific payload in `data.azure` or `data.google`, so you can pass the detected results into your own logic.

If you are routing between providers, the same service name covers both Azure and Google paths, making it straightforward to switch between file upload and URL-based processing without changing the overall integration pattern.

## Usage

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