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

# AI Video Person Detection API

Detect people in media from a file or URL using Azure or Google. Returns provider-specific results in a structured data object.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/ai/video/detect/person/url` | What it does Detects persons in a media file provided by URL and returns a JSON object with a data… | 500 |
| POST | `/ai/video/detect/person/file` | What it does Uploads a file to run person detection using either the Azure or Google route, based o… | 500 |

## About

## What it does
Person Detection identifies people in video or image files and returns the result from either Azure or Google processing, depending on the service you request. Send a file or a URL, choose `requested_service`, and get the structured detection output back in the `data` object.

Use the `/url` endpoint when your media is already hosted, or `/file` when you want to upload it directly. The URL route accepts `url` plus `requested_service`, and can also take Azure connection details (`region`, `account_id`, `access_token`) or Google credentials (`google_language`, `google_credential_json`). The file route accepts `file` plus `requested_service`, with Azure fields split into `azure_region`, `azure_account_id`, and `azure_access_token`, or a `google_credential_file` upload for Google routes.

This is useful when you need to flag frames or assets that contain people, such as moderation pipelines, media indexing, or video analysis workflows. The response is returned under `data`, with either an `azure` or `google` object present depending on the provider you selected.

Because the provider-specific payload is passed through in the response, you can integrate Person Detection into existing Azure- or Google-based processing without translating the result into a different schema.

| 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/detect-persons