Language Detection

Sunbird AI can automatically detect the language of a given text or audio file. This is useful for routing content to the correct translation or transcription pipeline.

Text Language Identification

Use the /tasks/language_id endpoint to identify the language of a text string.

Supported Languages

The classifier covers 64 languages — mostly African, plus English and French. A language is only reported when the model’s confidence clears the server-side threshold (default 0.35); below that, language is "language not detected" and confidence is null. text must be 3–200 characters.

Example Request

import os
import requests
from dotenv import load_dotenv

load_dotenv()

url = "https://api.sunbird.ai/tasks/language_id"
access_token = os.getenv("AUTH_TOKEN")

headers = {
    "accept": "application/json",
    "Authorization": f"Bearer {access_token}",
    "Content-Type": "application/json",
}

payload = {"text": "Oli otya? Webale nnyo ku kujja wano."}

response = requests.post(url, headers=headers, json=payload)
result = response.json()
print(f"Detected language: {result}")

const response = await fetch('https://api.sunbird.ai/tasks/language_id', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <YOUR_TOKEN>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ text: 'Oli otya? Webale nnyo ku kujja wano.' })
});
console.log(await response.json());

Response

{
  "language": "lug",
  "confidence": 0.98
}

confidence is the model’s 0–1 confidence in the identified language (omitted when the model does not report one). Filter on it if you want a stricter bar than the server’s threshold. When no language clears the threshold:

{
  "language": "language not detected",
  "confidence": null
}

Audio Language Detection

Use the /tasks/auto_detect_audio_language endpoint to identify the language spoken in an audio file.

Example Request

import os
import requests
from dotenv import load_dotenv

load_dotenv()

url = "https://api.sunbird.ai/tasks/auto_detect_audio_language"
access_token = os.getenv("AUTH_TOKEN")

files = {"audio": open("recording.mp3", "rb")}
headers = {"Authorization": f"Bearer {access_token}"}

response = requests.post(url, files=files, headers=headers)
print(response.json())

Response

{
  "detected_language": "ach"
}

Getting Started

Guides

Support

Text Language Identification

Supported Languages

Example Request

Response

Audio Language Detection

Example Request

Response

​Text Language Identification

​Supported Languages

​Example Request

​Response

​Audio Language Detection

​Example Request

​Response

Text Language Identification

Supported Languages

Example Request

Response

Audio Language Detection

Example Request

Response