Theme

VoiceLab API ​

Reference for text, speech, and realtime VoiceLab integrations.

Base URL: https://api.voicelab.uz
Auth: X-Api-Key on every REST request; realtime uses query token or gRPC metadata.

Hosts and package names

API base: https://api.voicelab.uz. API keys: VoiceLab app. SDK/CLI package is still aisha-ai (AISHA_API_KEY).

SDK quick start ​

Prefer the dedicated guides:

bash
export AISHA_API_KEY=your_api_key
npm install aisha-ai   # or: pip install aisha-ai
npx aisha-ai tts "Salom dunyo" --model Gulnoza --out salom.wav

Built-in endpoints ​

APIEndpointNotes
TTSPOST /api/v1/tts/post/Create audio (sync/async)
TTSGET /api/v1/tts/status/{id}/Check async status
TTSGET /api/v1/tts/get/?page=1&limit=10History
STTPOST /api/v1/stt/post/Short audio transcription
STTGET /api/v1/stt/get/?page=1&limit=10Short transcription history
STTPOST /api/v2/stt/post/Long audio async transcription
STTGET /api/v2/stt/get/?page=1&limit=10Long audio history
STTGET /api/v2/stt/get/{id}/Long transcription detail
STTGET /task-status/{task_id}/?instance_id={id}Task status (JWT; not API key)

Realtime ​

  • TTS: wss://api.voicelab.uz/api/v1/tts/realtime?token=...
  • STT: wss://api.voicelab.uz/api/v1/stt/realtime?format=webm&token=...
  • gRPC: api.voicelab.uz:443

TTS API ​

Full examples: TTS API.

STT API ​

Full examples: STT API.

Integration checklist ​

  1. Create an API key in the VoiceLab app.
  2. Send X-Api-Key on every server request.
  3. Start with a sync endpoint (/api/v1/tts/post/ or /api/v1/stt/post/), then wire status/history.
  4. Use WebSocket or gRPC for long-lived realtime sessions.

Machine-readable ​

For LLMs and automation:

Next ​