▣ ARTIFICIAL INTELLIGENCE · AUDIO PROCESSING

AI Video Language Detection API

What it does

Video Language Detector identifies the spoken language in a video and returns Azure’s language detection result with a confidence score.

Send either a video URL or an uploaded video file. For URL-based requests, provide url in the request body. For file-based requests, upload file as binary video content up to 10 MB. In both cases, the response comes back under data.azure with language and confidence, so you can use the same output shape whether you are processing hosted media or local uploads.

Use Video Language Detector when you need to route videos by language, choose the right transcription model, or filter incoming media in a content pipeline. A typical workflow is to detect the language before running speech-to-text, then apply language-specific processing downstream.

The response is simple and machine-friendly: language is returned as a locale-style code such as en-US, and confidence is a numeric score you can use to decide whether to trust the detection or fall back to manual review.

▣ ENDPOINT 01 / 02

POST

Detect language from video URL

https://api.eu.apyverse.com/apyhub/detect-video-language/url

QUICKSTART

GUIDE

Quickstart

Detect the language of a video from its URL.

curl -X POST "https://api.eu.apyverse.com/apyhub/detect-video-language/url" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://assets.apyhub.com/samples/sample.mp4"}'

What you'll get back

Returns a JSON object with a data object. Inside data, the azure object may include a detected language string and confidence number.

{
  "data": {
    "azure": {
      "language": "en-US",
      "confidence": 0.88
    }
  }
}

TRY ITLIVE · 500 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Detects the spoken language in a video accessible by URL and returns the detected language details in the response.

Request Body

Parameter	Type	Mandatory	Description
url	String	Yes	Video URL to analyze. Must be a URI.

Response

Returns a JSON object with a data object field. Inside data, the response may include an azure object containing the detected language string and confidence number.

Parameter	Type	Mandatory	Description
data	Object	Yes	Wrapper object for the detection result.
data.azure	Object	No	Azure detection result object.
data.azure.language	String	No	Detected language code.
data.azure.confidence	Number	No	Confidence score returned for the detected language.

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ ENDPOINT 02 / 02

POST

Detect language from uploaded video

https://api.eu.apyverse.com/apyhub/detect-video-language/file

QUICKSTART

GUIDE

Quickstart

Upload a video file to detect its language.

curl -X POST "https://api.eu.apyverse.com/apyhub/detect-video-language/file" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/video.mp4"

What you'll get back

Returns a JSON object with a data object. Inside data, azure is an object with language (a string like en-US) and confidence (a number like 0.88).

{
  "data": {
    "azure": {
      "language": "en-US",
      "confidence": 0.88
    }
  }
}

TRY ITLIVE · 500 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

About this endpoint

What it does

Uploads a video file and returns the detected language information in the response. The output is a JSON object containing a data object with an azure object that may include the detected language and confidence.

Request Body

Parameter	Type	Mandatory	Description
file	String	Yes	Video file upload. Max 10 MB.

Response

Returns a JSON object with a required data object field. Inside data, the azure object may contain language and confidence fields.

Parameter	Type	Mandatory	Description
data	Object	Yes	Response wrapper object.
data.azure	Object	No	Azure language detection result object.
data.azure.language	String	No	Detected language code.
data.azure.confidence	Number	No	Confidence score as a float.

Body

Name

Type

Description

bodyREQUIRED

object

—

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.