Quickstart

Create an account

Go to sonexlabs.com and sign up. Once logged in, you will be placed in a workspace (tenant).

Generate an API key

In the sidebar, go to Configurations → Developer. Under the API Keys tab, click Create key, give it a name, and copy the key immediately — it is shown only once.

Make your first request

Replace YOUR_API_KEY and VOICE_ID below. You can find voice IDs by calling GET /v1/voices or browsing the voices in your dashboard.

curl -X POST https://api.sonexlabs.com/v1/speech \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello, welcome to SonexLabs.",
    "voice_id": "VOICE_ID",
    "output_format": "wav"
  }' \
  --output speech.wav

A successful response returns raw audio bytes with Content-Type: audio/wav.

List available voices

Fetch the voices available to your workspace. The id field is what you pass as voice_id.

curl https://api.sonexlabs.com/v1/voices \
  -H "Authorization: Bearer YOUR_API_KEY"

[
  {
    "id": "abc123xyz",
    "name": "Priya",
    "language": "hi-IN",
    "gender": "female",
    "type": "platform",
    "preview_url": "https://..."
  }
]

Check your balance

Each synthesis call deducts from your TTS service credits first, then from your wallet balance. Check your remaining balance at any time:

curl https://api.sonexlabs.com/v1/balance \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "wallet": { "balance": 5.00, "currency": "USD" },
  "credits": [
    { "service": "tts", "available": 50000, "next_expiry": "2027-06-01T00:00:00Z" }
  ]
}