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

# AI Video Shot Change Detection API

Analyze a video file or URL and get shot change results back under Azure or Google. Useful for scene segmentation, indexing, and review workflows.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/ai/video/detect/shot/change/file` | What it does Uploads a video file and runs shot change detection using the requested service provid… | 500 |
| POST | `/ai/video/detect/shot/change/url` | What it does Detects shot changes for a video file provided by URL and returns a JSON object with t… | 500 |

## About

## What it does
Shot Change Detection analyzes a video file or video URL and returns detection results under the requested provider response. Send the media as a binary file or as a URL, then choose `requested_service` as `azure` or `google`.

Use the `/file` endpoint when you already have the video on hand. It requires `file` and `requested_service`, and can also accept Azure credentials such as `azure_region`, `azure_account_id`, and `azure_access_token`, or a Google service account file in `google_credential_file` for Google routes. Use `/url` when the video is already hosted elsewhere; it requires `url` and `requested_service`, and can include Azure settings in the `azure` object or Google settings in the `google` object, including `google_language` and `google_credential_json`.

The response is wrapped in `data` and returns either an `azure` object or a `google` object depending on the selected service. That makes it straightforward to plug into workflows that need to segment long-form video, identify scene boundaries, or trigger downstream processing when the content changes.

If you are building media indexing, video review tooling, or highlight extraction, Shot Change Detection gives you a provider-aware endpoint for turning video input into shot-level change results.

| 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-shot-changes