# Kurdish TTS

> Kurdish TTS is a text-to-speech (TTS), speech-to-text (STT), and voice-chat platform built specifically for the Kurdish language — both Sorani (Central Kurdish, Arabic script) and Kurmanji (Northern Kurdish, Latin script). It is one of the only providers of Kurdish speech AI, offering 664 natural AI voices, a free tier, mobile apps, and a paid developer HTTP API for TTS and STT.

## Products

- [Kurdish Text-to-Speech](https://www.kurdishtts.com/tts): Convert Kurdish (Sorani/Kurmanji) text to natural speech with 664 AI voices. Built-in translation from 124+ languages to Kurdish, then speak. Download MP3/WAV.
- [Kurdish Speech-to-Text](https://www.kurdishtts.com/stt): Transcribe Kurdish audio (Sorani/Kurmanji) via file upload or live streaming. Supports speaker diarization and word-level timestamps.
- [Kurdish Voice Chat](https://www.kurdishtts.com/conversation): Natural voice conversations with a Kurdish AI assistant in Sorani or Kurmanji, with one-tap translation of every message.

## Developer API

- [API reference](https://www.kurdishtts.com/docs/api): Full developer reference for the paid TTS + STT HTTP API — endpoints, authentication, parameters, and curl/Python/JavaScript examples.
- [Guides](https://www.kurdishtts.com/docs/guides): Step-by-step tutorials — [add Kurdish voice to Claude (MCP)](https://www.kurdishtts.com/docs/guides/claude-kurdish-voice), [Kurdish text-to-speech in Python/JS](https://www.kurdishtts.com/docs/guides/kurdish-text-to-speech-api), [transcribe Kurdish audio](https://www.kurdishtts.com/docs/guides/transcribe-kurdish-audio).
- [OpenAPI 3.1 spec](https://www.kurdishtts.com/openapi.json): Machine-readable contract for the TTS + STT API.
- [API pricing](https://www.kurdishtts.com/pricing): Plans ($0 free tier, $5, $8, $19/month; yearly billing $48–$182/year, 20% off) and per-credit pricing.
- Authentication: `x-api-key` header. TTS and STT use separate API keys.
- API base URL: `https://www.kurdishtts.com/api`
  - `POST /api/tts-proxy` — text-to-speech (params: `text`, `speaker_id`, `model_version` = `v3`|`v4`, optional `speed`, `include_timestamps`).
  - `POST /api/stt-proxy` — speech-to-text from an uploaded audio file (multipart: `file`, `dialect` = `sorani`|`kurmanji`).
  - `POST /api/stt-stream-connect` — open a live streaming STT session (returns a WebSocket URL).
  - `GET /api/get-speakers` — public, no-auth catalog of available voices (optional `?model_version=v3|v4`).

## MCP Server (for AI agents)

- MCP endpoint: `https://www.kurdishtts.com/api/mcp` (Streamable HTTP transport).
- Authentication: `Authorization: Bearer <api-key>` — use your TTS or STT API key, or `<ttsKey>:<sttKey>` for both. Keys are issued in the account dashboard; usage is billed against your plan exactly like the HTTP API.
- Tools: `synthesize_speech`, `transcribe_audio`, `start_streaming_transcription`, `list_voices`, `list_dialects`.
- Payload limits over MCP: 600 characters per synthesis, 4MB audio per transcription — use the HTTP API above for larger jobs.

## Pricing

- [Plans](https://www.kurdishtts.com/plans): Website plans and free tier.
- [API pricing](https://www.kurdishtts.com/pricing): Developer API plans.

## Languages

- [Sorani — Central Kurdish (کوردی سۆرانی)](https://www.kurdishtts.com/ckb)
- [Kurmanji — Northern Kurdish (Kurdî Kurmancî)](https://www.kurdishtts.com/kmr)

## Optional

- [FAQ](https://www.kurdishtts.com/faq): Frequently asked questions about dialects, pricing, translation and accessibility.
- [About & founder](https://www.kurdishtts.com/about): The mission and founder (Bear Rizgar, from Qaladze, Southern Kurdistan).
- [Contact](https://www.kurdishtts.com/contact): Support and contact.