Authentication

Every request to the Vulavula API is authenticated with an API key, passed in the X-CLIENT-TOKEN header.

Get your API key

1. Sign up or log in at vulavula.lelapa.ai — with email and password, or a social sign-in option such as GitHub.
2. Generate a key: navigate to the API Keys section and click Generate API Key.
3. Copy the key and keep it somewhere safe — you'll send it as the X-CLIENT-TOKEN header with every request.

Use your key

Include the header on any endpoint. For example, calling the Translate API:

Code
import requests

response = requests.post(
    "https://api.lelapa.ai/v1/translate/process",
    headers={"X-CLIENT-TOKEN": "<INSERT_TOKEN>"},
    json={
        "input_text": "Lo musho ubhalwe ngesiZulu.",
        "source_lang": "zul_Latn",
        "target_lang": "eng_Latn",
    },
)
print(response.json())

A missing or invalid key returns 401 Unauthorized.

Keep your key safe

• Don't hard-code keys in source code or commit them to version control — load them from an environment variable or a secrets manager.
• Rotate keys if you suspect one has leaked; generate a new key on the platform and retire the old one.
• Use separate keys per project where possible, so a leaked key has limited blast radius.

Next steps

• Make your first transcription with the Speech-to-Text API
• Translate text with the Translate API
• Skip raw HTTP with the Python SDK