VULAVULA BETA DOCUMENTATION
Introducing an API solution tailored for Africa’s most widely spoken languages. This Beta API offers transcription and sophisticated analysis capabilities, enabling seamless comprehension and integration, for Sesotho, Afrikaans, South African English and isiZulu. Are you ready to dive in?
We have swagger docs deployed HERE for further information on how to engage with the key.
Get your API token
- Signup and login to Vulavula Beta HERE
- Generate a Beta API token. This’ll be used in the X-CLIENT-TOKEN header in your requests
- There is a limit of 100 free calls per token.
We recommend you checkout our Colab Tutorial to easily interact with the APIs
NOTE: Our models sometimes go to sleep (because running all day is tiring and expensive). We're busy streamlining our morning routine and optimizing our energy. Until we get that right, you might occasionally receive a 503 HTTP error when using our APIs. We ask you to retry the call until the model has woken up.
TRANSCRIPTION
Let’s get transcribing in isiZulu, seSotho, Afrikaans and South African English!
DATASHEETS
Lelapa-Datasheet-Lelapa-X-ASR-isiZulu-and-seSotho.pdf
Lelapa-Datasheet-Lelapa-X-ASR-ZA-English.pdf
Lelapa-Datasheet-Lelapa-X-ASR-Afrikaans.pdf
MODEL CARDS
Lelapa-Model-Card-Lelapa-X-ASR-isiZulu-and-seSotho.pdf
Lelapa-Model-Card-Lelapa-X-ASR-ZA-English.pdf
Lelapa-Model-Card-Lelapa-X-ASR-Afrikaans.pdf
SETUP AND CONFIG
- Install
pip install retry-requests
.This allows us to retry requests.
VULAVULA_BASE_URL = “https://beta-vulavula-services.lelapa.ai/api/v1/”
Right now it’s single files only, and is a little fiddly. Check it out in coming weeks and we’ll have a slightly different API
LETS GET TRANSCRIBING
Our responses to the API are delivered by webhook, which you configure in this call below.
Additionally, optionally, you can specify a language code to specify which model you’re speaking on. The following language codes are valid
- AFRIKAANS = “afr”
- ISIZULU = “zul”
- SESOTHO = “sot”
- RSA_ENGLISH = “eng”
If no language code is specified, our built-in language ID will select the most probably language.
NAMED ENTITY RECOGNITION
Our named entity recognition is a simply post request. We include a retry in case our models are still sleeping
DATASHEET
Lelapa-Datasheet-Lelapa-X-NER-isiZulu.pdf
MODEL CARD
Lelapa-Model-Card-Lelapa-X-NER-isiZulu.pdf
SENTIMENT AnALYSIS
Sentiment analysis is a simple call to our servers.
DATASHEET
Lelapa-Datasheet-Lelapa-X-Sentiment-isiZulu.pdf
MODEL CARD
Lelapa-Model-Card-Lelapa-X-Sentiment-isiZulu.pdf