> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kova.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Make your first request and save an MP3 in under 60 seconds.

## 1. Get an API key

Sign in at [platform.kova.ai](https://platform.kova.ai) and create a key on the [API keys page](https://platform.kova.ai/dashboard/api-keys). Keys start with `kova_sk_`.

<Warning>Keep your key secret. Anyone with the key can spend your credits.</Warning>

## 2. Install the SDK

<CodeGroup>
  ```sh Python theme={null}
  pip install kova-tts
  ```

  ```sh Node.js theme={null}
  npm install @kova-ai/tts
  ```

  ```sh cURL theme={null}
  # Already on your machine.
  ```
</CodeGroup>

## 3. Make your first request

<CodeGroup>
  ```python Python theme={null}
  import os
  from kova_tts import KovaTTSClient, AudioResponseFormat

  client = KovaTTSClient(api_key=os.environ["KOVA_API_KEY"])

  result = client.tts(
      text="Hello from Kova.",
      voice="cal",
      response_format=AudioResponseFormat(encoding="mp3"),
  )

  client.write_audio_file(result.audio, "out.mp3")
  print("wrote out.mp3")
  ```

  ```ts Node.js theme={null}
  import { KovaTTSClient } from "@kova-ai/tts";

  const client = new KovaTTSClient({ apiKey: process.env.KOVA_API_KEY! });

  const result = await client.tts({
    text: "Hello from Kova.",
    voice: "cal",
    response_format: { encoding: "mp3" },
  });

  await client.writeAudioFile(result.audio, "out.mp3");
  console.log("wrote out.mp3");
  ```

  ```bash cURL theme={null}
  curl https://api.kova.ai/v1/tts \
    -H "x-api-key: $KOVA_API_KEY" \
    -H "content-type: application/json" \
    -d '{"text":"Hello from Kova.","voice":"cal","response_format":{"encoding":"mp3"}}' \
    | jq -r .audio | base64 -d > out.mp3
  ```
</CodeGroup>

## 4. Play it

```sh theme={null}
open out.mp3   # macOS
xdg-open out.mp3   # Linux
```

You should hear "Hello from Kova." in the **cal** voice.

## What's next

<CardGroup cols={2}>
  <Card title="Streaming TTS" icon="bolt" href="/api-reference/http/streaming-tts">
    Start playback before generation finishes.
  </Card>

  <Card title="WebSocket API" icon="plug" href="/api-reference/websocket/overview">
    Real-time, multi-utterance voice experiences.
  </Card>

  <Card title="Voices" icon="microphone" href="/voices">
    Browse all available speakers.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Where keys come from and how to manage them.
  </Card>
</CardGroup>