> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Aan de slag met ElevenAPI

Aan het einde van deze handleiding heb je een werkend script dat een tekenreeks naar de ElevenLabs API stuurt en de teruggestuurde audio via je speakers afspeelt. Je leert hoe je je met een API-sleutel authenticeert, de SDK installeert en je eerste Text to Speech-request uitvoert.

Zie voor handleidingen over andere mogelijkheden — streaming, stemklonen, Speech to Text — de sectie [Tutorials](/docs/nl/eleven-api/guides/cookbooks).

> **Tip**
>
> Gebruik de [ElevenLabs Text to Speech-skill](https://github.com/elevenlabs/skills/tree/main/text-to-speech) om spraak te genereren vanuit je AI-codeassistent:
>
> ```bash
> npx skills add elevenlabs/skills --skill text-to-speech
> ```

## De Text to Speech-API gebruiken

#### Een API-sleutel maken

[Maak hier een API-sleutel in het dashboard](https://elevenlabs.io/app/settings/api-keys), die je gebruikt voor veilige [toegang tot de API](/docs/nl/api-reference/authentication).

Sla de sleutel op als beheerd geheim en geef deze aan de SDK's door als omgevingsvariabele via een `.env`-bestand, of rechtstreeks in de configuratie van je app, afhankelijk van je voorkeur.

**`.env`**

```js title=".env"
ELEVENLABS_API_KEY=<your_api_key_here>
```

#### De SDK installeren

#### SDK

We gebruiken ook de `dotenv`-bibliotheek om onze API-sleutel uit een omgevingsvariabele te laden.

```python
pip install elevenlabs
pip install python-dotenv
```

```typescript
npm install @elevenlabs/elevenlabs-js
npm install dotenv
```

#### CLI

Installeer de ElevenLabs CLI. Homebrew (macOS) en Scoop (Windows) worden aanbevolen.

**`Homebrew (macOS)`**

```bash title="Homebrew (macOS)"
brew install elevenlabs/tap/elevenlabs
```

**`Scoop (Windows)`**

```powershell title="Scoop (Windows)"
scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket
scoop install elevenlabs
```

**`npm`**

```bash title="npm"
npm install -g @elevenlabs/cli
```

**`curl`**

```bash title="curl"
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh
```

> **Tip**
>
> Werk je met een AI-code-assistent? Voer `elevenlabs generate-skills` uit in je project om voor elke
> commandogroep een `SKILL.md` naar `skills/` te schrijven, zodat je assistent alle mogelijkheden van de CLI kent
> zonder dat je documentatie hoeft te plakken. Gebruik `--output-dir` om ze ergens anders te plaatsen. Dit leest de eigen
> ingebouwde API-definitie van de CLI, dus er is geen API-sleutel nodig en het werkt offline — en het blijft afgestemd op
> de versie van de CLI die je hebt geïnstalleerd.

Verifieer je daarna — hiermee wordt je browser geopend om de CLI te autoriseren:

```bash
elevenlabs auth login
```

> **Note**
>
> Mogelijk word je gevraagd [MPV](https://mpv.io/)
> en/of [ffmpeg](https://ffmpeg.org/) te installeren om de audio via je speakers af te spelen.

#### Je eerste request uitvoeren

#### SDK

Maak een nieuw bestand met de naam `example.py` of `example.mts`, afhankelijk van de taal die je kiest, en voeg de volgende code toe:

```python
from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
from elevenlabs.play import play
import os

load_dotenv()

elevenlabs = ElevenLabs(
  api_key=os.getenv("ELEVENLABS_API_KEY"),
)

audio = elevenlabs.text_to_speech.convert(
    text="The first move is what sets everything in motion.",
    voice_id="JBFqnCBsd6RMkjVDRZzb",  # "George" - browse voices at elevenlabs.io/app/voice-library
    model_id="eleven_v4",
    output_format="mp3_44100_128",
)

play(audio)

```

```typescript
import { ElevenLabsClient, play } from "@elevenlabs/elevenlabs-js";
import "dotenv/config";

const elevenlabs = new ElevenLabsClient();
const audio = await elevenlabs.textToSpeech.convert(
	"JBFqnCBsd6RMkjVDRZzb", // "George" - browse voices at elevenlabs.io/app/voice-library
	{
		text: "The first move is what sets everything in motion.",
		modelId: "eleven_v4",
		outputFormat: "mp3_44100_128",
	},
);

await play(audio);

```

Voer het vervolgens uit:

```python
python example.py
```

```typescript
npx tsx example.mts
```

Je zou de audio via je speakers moeten horen afspelen.

#### CLI

Genereer spraak en sla deze op in een MP3-bestand:

```bash
elevenlabs text-to-speech convert \
  --voice-id JBFqnCBsd6RMkjVDRZzb \
  --model-id eleven_v4 \
  --text "The first move is what sets everything in motion." \
  --output-format mp3_44100_128 \
  --output audio.mp3
```

Open `audio.mp3` om het resultaat te horen.

## Volgende stappen

#### [Audio streamen](/docs/nl/eleven-api/guides/how-to/text-to-speech/streaming)

Verminder latency door audio te streamen tijdens het genereren, in plaats van op het volledige bestand te wachten

#### [Stemmen bekijken](https://elevenlabs.io/app/voice-library)

Verken meer dan 10.000 stemmen en vervang de voorbeeld-stem-ID door een ID die bij je use case past

#### [Een stem klonen](/docs/nl/eleven-api/guides/how-to/voices/instant-voice-cloning)

Maak een aangepaste stem op basis van een korte audio-opname