Skip to main content
All requests require an API key in the Authorization header.

Base URL

http://stt.sawt.sa/

Authentication

Authorization
required
Bearer your-api-key-here

POST /transcribe

Transcribe audio files to text with confidence scoring.

Request Headers

Authorization
required
Bearer YOUR_API_KEY
Content-Type
required
multipart/form-data

Request Parameters

file
file
required
Audio file (supported formats: WAV, MP3, M4A, etc.)
job_id
string
Custom job identifier for tracking (optional)

Audio Requirements

  • Minimum duration: 10 milliseconds
  • Automatically resampled to 16kHz
  • Supports common audio formats (WAV, MP3, M4A, etc.)

Response

transcription
string
required
The transcribed text from the audio file
confidence
number
required
Confidence score of the transcription (0-1)
{
  "transcription": "النص المكتوب",
  "confidence": 0.95
}

Error Codes

Status CodeDescription
400Invalid audio file or processing error
401Invalid or missing API key
500Internal server error
curl -X POST "http://stt.sawt.sa/transcribe" \
  -H "Authorization: Bearer your-api-key" \
  -F "[email protected]"