Kurdish voice AI, for developers
A fast REST API for Kurdish text-to-speech and speech-to-text. One-shot or streaming, word-level timestamps. Text-to-speech: Sorani, Kurmanji and Badini (a variety of Kurmanji, in the Arabic script). Speech-to-text: Sorani and Kurmanji. Free to start.
# Text to speech → saves hello.wav
curl -X POST https://www.kurdishtts.com/api/tts-proxy \
-H "x-api-key: $KURDISH_TTS_KEY" \
-H "Content-Type: application/json" \
-d '{"speaker_id": "sorani_1", "model_version": "v4", "text": "سڵاو، ئەمە دەنگی کوردییە."}' \
--output hello.wav
POST /api/tts-proxy → returns audio/wav
Start in three steps
From zero to your first Kurdish audio in a couple of minutes.
Create an API key
Generate a key under Settings → API. It's shown once, so store it as an environment variable.
Call the endpoint
POST with your x-api-key header and a JSON body. Omit model_version for v3, or pass "v4" — both keep working exactly as they do today.
Receive audio
The response is audio/wav. Add "include_timestamps": true for word-level timings and a JSON payload.
One API, three endpoints
Authenticate every request with your x-api-key header.
/api/tts-proxyText to speech
Send text, get natural Kurdish audio back as WAV, with optional word-level timestamps.
/api/stt-proxySpeech to text
Upload an audio file, get a transcript back. Sorani or Kurmanji, with word-level timings.
/api/stt-stream-connectStreaming STT
Open a short-lived WebSocket and transcribe audio in real time as it arrives.
# Speech to text → JSON transcript
curl -X POST https://www.kurdishtts.com/api/stt-proxy \
-H "x-api-key: $KURDISH_STT_KEY" \
-F "file=@audio.wav" \
-F "dialect=sorani"
Or skip the code — connect over MCP
Claude, Claude Code and Cursor call Kurdish speech natively over the Model Context Protocol.
claude mcp add --transport http kurdish-tts \
https://www.kurdishtts.com/api/mcp \
--header "Authorization: Bearer YOUR_TTS_KEY:YOUR_STT_KEY"
Three of the six tools work with no API key, so an agent can browse the voice catalog before you sign up. MCP setup guide for Claude and Cursor.
Pricing
One subscription covers the web app and the developer API. Pick the side you work on, or take both. Start free, no credit card. Every plan runs on V5, our newest model — the V3 and V4 voices are still inside it, alongside the new Cast and Studio voices, so there is no older model to buy your way out of.
10,000 characters / month in the web app · 20,000 characters / month through the API · 2 hours Speech-to-text / month · 6 voices (Web app) · 10 voices (API)
Evaluation and testing only
Creator
billed $115 / year
For people making things in the web app.
- 1M characters / month in the web app
- 20,000 characters / month through the API
- 20 hours Speech-to-text / month
- All 891 voices, Sorani and Kurmanji — six of them Badini
- One-shot and streaming, on both TTS and STT
- Commercial use
Cancel anytime · 30-day money-back
Developer
billed $182 / year
For people building Kurdish voice into their own product.
- 10,000 characters / month in the web app
- 1M characters / month through the API
- 20 hours Speech-to-text / month
- All 891 voices, Sorani and Kurmanji — six of them Badini
- One-shot and streaming, on both TTS and STT
- Commercial use
Cancel anytime · 30-day money-back
Pro
billed $278 / year
Both sides at full volume, and the right to ship what you make.
- 3M characters / month in the web app
- 3M characters / month through the API
- 100 hours Speech-to-text / month
- All 891 voices, Sorani and Kurmanji — six of them Badini
- One-shot and streaming, on both TTS and STT
- Commercial use and redistribution
Cancel anytime · 30-day money-back
Business
billed $950 / year
For companies with contracts, affiliates and a procurement team.
- 10M characters / month in the web app
- 10M characters / month through the API
- 333 hours Speech-to-text / month
- All 891 voices, Sorani and Kurmanji — six of them Badini
- One-shot and streaming, on both TTS and STT
- Redistribution, affiliates, and a data processing agreement
Cancel anytime · 30-day money-back
Enterprise
CustomFor teams running Kurdish speech in production, where uptime and procurement matter as much as throughput.
Everything in Business, plus:
Compare every plan
| Feature | Free | Creator | Developer | Pro | Business |
|---|---|---|---|---|---|
| Characters / month · Web app | 10,000 | 1M | 10,000 | 3M | 10M |
| Characters / month · API | 20,000 | 20,000 | 1M | 3M | 10M |
| Speech-to-text / month | 2 hours | 20 hours | 20 hours | 100 hours | 333 hours |
| Voices (Web app) | 6 | 891 | 891 | 891 | 891 |
| Voices (API) | 10 | 891 | 891 | 891 | 891 |
| Live streaming sessions | 20 | 100 | 100 | 500 | 2,000 |
| Longest live session | 2 minutes | 10 minutes | 10 minutes | 30 minutes | 60 minutes |
| Largest audio upload | 10MB | 50MB | 50MB | 100MB | 200MB |
| Transcript length | 500 | Unlimited | Unlimited | Unlimited | Unlimited |
| Licence | Evaluation and testing only | Commercial use | Commercial use | Commercial use and redistribution | Redistribution, affiliates, and a data processing agreement |
The licence is what separates the tiers, not the volume. What you may do with the audio is set out in full in the terms.
Need more API characters?
Top up without changing plan. Packs never expire and are used automatically once your monthly allowance runs out. They apply to the API only, not the web app.
500,000 characters
$0.006 / 1K chars
500,000 characters added to your balance. Purchased characters survive the monthly reset.
1M characters
$0.005 / 1K chars
1M characters added to your balance. Purchased characters survive the monthly reset.
5M characters
$0.004 / 1K chars
5M characters added to your balance. Purchased characters survive the monthly reset.
Limits and quotas
Published in Free · Creator · Pro · Business order. A request past a free-tier quota returns a 403 with an upgrade hint, never a silent failure. Paid plans keep working past their included volume and we email you.
- Per-request text
- 500 chars (free) · 5,000 (paid)
- STT upload size
- 10MB · 50MB · 100MB · 200MB
- TTS quota (API)
- 20,000 · 20,000 · 3M · 10M Characters / month
- STT audio
- 2 · 20 · 100 · 333 hours
- Live streaming sessions
- 20 · 100 · 500 · 2,000
- Longest live session
- 2 · 10 · 30 · 60 minutes
- Rate limiting
- Quota-based (403 past quota)
- Dialect
- Inferred from the speaker_id prefix
At Pro the plan works out at $9.67 per 1,000,000 characters, and the same subscription covers the web app and 100 hours of speech-to-text rather than billing them separately.
Build with Kurdish voice today
Generate a key and make your first call in minutes. Free tier, no credit card.