Speech to Text (Transcription)

Our Speech-to-Text (STT) technology is powered by specialized models trained to accurately recognize African languages. Unlike generic transcription services, our models are optimized for the specific phonemes, accents, and dialects of Amharic and Afan Oromo.

Usage Guide

Speech-to-text uploads use multipart/form-data. The SDK handles the transport format when you pass an audio file and language.

Transcribe a File

Upload an audio file to get the text transcription.

import AddisAI, { fileFromPath } from "addisai";

const addis = new AddisAI();
const result = await addis.speech.transcribe({
  audio: await fileFromPath("audio.wav"),
  language: "am",
});

console.log(result.text);
console.log(result.confidence);

from addisai import AddisAI

addis = AddisAI()
with open("audio.wav", "rb") as audio:
    result = addis.speech.transcribe(audio=audio, language="am")

print(result["text"])
print(result.get("confidence"))

curl --location 'https://api.addisassistant.com/api/v2/stt' \\
  --header 'x-api-key: $ADDIS_API_KEY' \\
  --form 'audio=@"audio.wav"' \\
  --form 'request_data="{ \"language_code\": \"am\" }"'

API Reference

Form Data Parameters

These fields are sent as multipart form data.

Request Data Object

These parameters go inside the request_data JSON string.

Response Schema

{
  "status": "success",
  "data": {
    "transcription": "ሰላም እንኳን ደህና መጣችሁ",
    "usage_metadata": {
      "totalBilledDuration": "15s",
      "requestId": "69b60667-0000-2a1e-b6d3-d4f547fe6724"
    }
  },
  "confidence": 0.982
}

Supported Formats

We support standard audio containers. For the fastest processing, we recommend WAV.

Best Practices

To ensure high accuracy (WER < 10%), follow these recording guidelines.