Speech To Text (STT)

Transcribe with the SDK

Transcribe an audio file by specifying the file path, with an optional webhook URL for asynchronous result delivery. The maximum audio length supported is 30 minutes.

New here? Get an API key first

The SDK client is initialised with an API key. Sign up at vulavula.lelapa.ai, generate a key, and see Authentication for the full walkthrough — every account includes 100 free API calls per month.

This method simplifies the process by combining both the upload and transcription steps into a single, easy-to-use SDK method.

Code
pdm add vulavula


Code
from vulavula import VulavulaClient
client = VulavulaClient("<INSERT_TOKEN>")

upload_id, transcription_result = client.transcribe(
    "path/to/your/audio/file.wav",
    webhook="<INSERT_URL>"
)
print("Transcription Submit Success:", transcription_result) #A success message, data is sent to webhook

Get Transcribed Text

This method allows one to ping the server to get the transcribed text. This is helpful for those who do not want to use a webhook.

Code
pdm add vulavula


Code
import time
while client.get_transcribed_text(upload_id)['message'] == "Item has not been processed.":
    time.sleep(5)
    print("Waiting for transcribe to complete...")
client.get_transcribed_text(upload_id)

Last modified on July 13, 2026

Sync Transcribe Transcription - isiZulu and seSotho

Speech To Text (STT)

Transcribe with the SDK

Transcribe an audio file by specifying the file path, with an optional webhook URL for asynchronous result delivery. The maximum audio length supported is 30 minutes.

New here? Get an API key first

This method simplifies the process by combining both the upload and transcription steps into a single, easy-to-use SDK method.

Code
pdm add vulavula


Code
from vulavula import VulavulaClient
client = VulavulaClient("<INSERT_TOKEN>")

upload_id, transcription_result = client.transcribe(
    "path/to/your/audio/file.wav",
    webhook="<INSERT_URL>"
)
print("Transcription Submit Success:", transcription_result) #A success message, data is sent to webhook

Get Transcribed Text

This method allows one to ping the server to get the transcribed text. This is helpful for those who do not want to use a webhook.

Code
pdm add vulavula


Code
import time
while client.get_transcribed_text(upload_id)['message'] == "Item has not been processed.":
    time.sleep(5)
    print("Waiting for transcribe to complete...")
client.get_transcribed_text(upload_id)

Last modified on July 13, 2026

Sync Transcribe Transcription - isiZulu and seSotho