Getting started

Send your first VoiceLab TTS or STT request in a few minutes.

1. Account and API key

1. Sign in to VoiceLab.
2. Open API keys and create a new key.
3. Store the secret immediately (secret manager or env) — you will not see the full value again.

Manage keys: voicelab.uz/app

2. Configure your environment

export AISHA_API_KEY=your_api_key

Base URL for all REST requests:

https://api.voicelab.uz

On every server request:

X-Api-Key: your_api_key

Optional: Accept-Language: uz | en | ru localizes API error messages.

3. Try the SDK / CLI or cURL

CLI (fastest)

npm install -g aisha-ai
# or use npx without a global install

npx aisha-ai tts "Salom dunyo" --model Gulnoza --out salom.wav
npx aisha-ai stt ./audio.wav

cURL — TTS

curl --request POST \
  --url https://api.voicelab.uz/api/v1/tts/post/ \
  --header "X-Api-Key: $AISHA_API_KEY" \
  --header "Accept-Language: en" \
  --form 'transcript=Hello from VoiceLab' \
  --form 'language=uz' \
  --form 'model=Gulnoza' \
  --form 'mood=Neutral' \
  --form 'speed=1.0'

Successful sync response (201):

{
  "audio_path": "/media/tts_audios/request-id.wav"
}

Full audio URL: https://api.voicelab.uz + audio_path.

cURL — STT

curl --request POST \
  --url https://api.voicelab.uz/api/v1/stt/post/ \
  --header "X-Api-Key: $AISHA_API_KEY" \
  --form 'audio=@./audio.wav' \
  --form 'language=uz'

4. Next steps

• Easy libraries → SDK & CLI
• Building with AI agents → For AI agents
• Auth details → Authentication
• Full TTS / STT HTTP → TTS · STT