Skip to content
POST
https://api.menavoice.ai/api/stt/transcribe
Try it
curl -X POST https://api.menavoice.ai/api/stt/transcribe \
  -H "x-api-key: $MENAVOICE_API_KEY" \
  -F "audio=@recording.mp3" \
  -F "language=ar"
{
  "text": "مرحباً بكم في مينا فويس",
  "minutes": 0.1,
  "mimeType": "audio/mpeg"
}

Transcribes a recording into text. Upload the audio as multipart/form-data, or send it base64-encoded in a JSON body.

Each request costs $25 per million characters of transcript, taken from your API credit. It needs a positive balance to start.

Authorizations

x-api-keystringrequired

Your API key. See Authentication.

Body

multipart/form-data
audiofilerequired

The recording: MP3, WAV, WebM, OGG, M4A or FLAC, up to 25 MB.

languagestring

The expected language as a BCP-47 code, such as ar, en or fr. Leave it out to detect the language automatically.

JSON body

application/json
audiostringrequired

The recording, base64-encoded. The whole JSON body must stay under 10 MB.

mimeTypestringdefault: audio/mpeg

The format of the audio, such as audio/wav or audio/mp4.

languagestring

The expected language as a BCP-47 code. Leave it out to detect the language automatically.

Response

application/json
textstringrequired

The transcript. Empty if no speech was found.

minutesnumberrequired

The billable length of the audio in minutes, rounded to a tenth (at least 0.1). The web app uses it to count plan minutes; API requests are billed on transcript characters instead.

mimeTypestringrequired

The audio format the file was read as.

Errors

StatusWhen
400No audio was sent, the format isn't supported, or the base64 is invalid.
401The API key is missing or invalid.
402Your API balance is zero or below.
413The file is over 25 MB, or the JSON body is over 10 MB.
429More than 30 requests in a minute, or more requests at once than your concurrency allows.

See Errors for the exact messages.

Was this page helpful?