▣ ARTIFICIAL INTELLIGENCE

AI Video Language Detection API

Hosted on ApyHub

What it does

Video Language Detection identifies the spoken language in an uploaded video file or a video URL and returns Azure’s language code with a confidence score.

Send Video Language Detection a binary video file to /file, or pass a video url to /url. Both endpoints accept one input only: either file or url. The response comes back under data.azure with language and confidence, so you can wire it directly into moderation, localization, or media-routing workflows.

Use it when you need to route user-generated video to the right transcription pipeline, pick a downstream subtitle template, or flag content for language-specific review. Because the output is a compact language code plus confidence value, it’s easy to store, compare, and threshold in automated systems.

The API is a good fit for media platforms, multilingual content tools, and intake pipelines that need a quick language signal before further processing.

Provider (requested_service)	Atoms
Azure	500

▣ ENDPOINT 01 / 02

POST

Detect language from uploaded video

http://localhost:8080/apyhub/detect-language-video/file

QUICKSTARTGUIDE

Quickstart

Upload a file to detect its language.

curl -X POST "http://localhost:8080/apyhub/detect-language-video/file" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/video.mp4"

What you'll get back

Returns a JSON object with a required data object. The data object can include an azure object with language and confidence fields.

{
  "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 detected language information in the response. The response includes a data object with language detection results under azure.

Request Body

Parameter	Type	Mandatory	Description
file	String	Yes	Video file (max 10 MB).

Response

Returns a JSON object with a data object field. Inside data, the response includes an optional azure object with language detection results.

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

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.

▣ ENDPOINT 02 / 02

POST

Detect language from video URL

http://localhost:8080/apyhub/detect-language-video/url

QUICKSTARTGUIDE

Quickstart

Send a URL for language detection.

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

What you'll get back

Returns a JSON object with a data object. Inside data, the azure object contains the 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 from a video available at a URL and returns the detected language details in the response.

Request Body

Parameter	Type	Mandatory	Description
url	String	Yes	A video URL in URI format.

Response

Returns a JSON object with a data object field. The data object contains an azure object, which in turn contains language and confidence fields.

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

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ 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.