> 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.

# Keyterm-prompting

> **Note**
>
> **Stapsgewijze handleiding** · Hierbij wordt ervan uitgegaan dat je de [korte introductie voor Speech to Text ](/docs/nl/eleven-api/guides/cookbooks/speech-to-text) hebt voltooid.

## Overzicht

> **Warning**
>
> Keyterm prompting is beschikbaar met Scribe v2, Scribe v2 Medical (batch) en Scribe v2 Realtime,
> en brengt extra kosten met zich mee. Bekijk de [API-prijspagina ](https://elevenlabs.io/pricing?price.section=speech_to_text\&price.sections=speech_to_text,speech_to_text#pricing-table)
> voor gedetailleerde prijsinformatie.

Keyterm prompting is een functie waarmee je woorden of zinnen kunt uitlichten om het model te sturen deze te transcriberen. Dit is handig voor het transcriberen van specifieke woorden of zinnen die niet vaak in de audio voorkomen, zoals productnamen, namen of andere specifieke termen. Keyterms zijn krachtiger dan bevooroordeelde keywords of aangepaste woordenlijsten die andere modellen bieden, omdat ze context gebruiken om te bepalen of die term moet worden getranscribeerd.

|                                    | Batch (Scribe v2 / Scribe v2 Medical) | Realtime (Scribe v2 Realtime) |
| ---------------------------------- | ------------------------------------- | ----------------------------- |
| Maximaal aantal keyterms           | 1000                                  | 50                            |
| Maximaal aantal tekens per keyterm | 50                                    | 20                            |

Als je bedrijfsnaam bijvoorbeeld geen veelgebruikte term is of een unieke spelling of uitspraak heeft, kun je keyterms gebruiken om ervoor te zorgen dat het model deze correct transcribeert. Neem de volgende audio:

<elevenlabs-audio-player audio-title="Voorbeeld van bedrijfsnaam" audio-src="https://storage.googleapis.com/eleven-public-cdn/documentation_assets/audio/stt-keyterm-prompting.mp3" />

Zonder keyterm prompting kan het model het bovenstaande als volgt transcriberen:

```
I work at eleven labs.
```

Hierbij wordt de verkeerde stijl voor de bedrijfsnaam gebruikt. Met keyterm prompting kun je ervoor zorgen dat het model het bovenstaande met de juiste spelling en stijl transcribeert:

```
I work at ElevenLabs.
```

### Context

Het model kan context gebruiken om te bepalen of een term moet worden getranscribeerd. Wanneer je de keyterm "ElevenLabs" opgeeft, wordt de bovenstaande audio naar verwachting getranscribeerd, maar het model kan op basis van de context nog steeds het volgende correct transcriberen:

<elevenlabs-audio-player audio-title="Voorbeeld van context" audio-src="https://storage.googleapis.com/eleven-public-cdn/documentation_assets/audio/stt-keyterm-prompting-context.mp3" />

Dit levert het volgende transcript op:

```
I've worked at many labs. In fact I've worked at eleven labs.
```

## Batchtranscriptie

Keyterm prompting is geïntegreerd in de batch-Speech to Text-API door de parameter `keyterms` door te geven aan de methode `convert`.

```python maxLines=0 {22-24}
import os
from dotenv import load_dotenv
from io import BytesIO
import requests
from elevenlabs.client import ElevenLabs

load_dotenv()

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

audio_url = (
    "https://storage.googleapis.com/eleven-public-cdn/documentation_assets/audio/stt-keyterm-prompting.mp3"
)
response = requests.get(audio_url)
audio_data = BytesIO(response.content)

transcription = elevenlabs.speech_to_text.convert(
    file=audio_data,
    model_id="scribe_v2", # Model to use
    # Keyterms to prompt the model with.
    # Up to 1000 keyterms can be provided, with a maximum length of 50 characters each
    keyterms=["ElevenLabs"],
)

print(transcription)
```

```typescript maxLines=0 {16-18}
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
import "dotenv/config";

const elevenlabs = new ElevenLabsClient({
  apiKey: process.env.ELEVENLABS_API_KEY,
});

const response = await fetch(
  "https://storage.googleapis.com/eleven-public-cdn/documentation_assets/audio/stt-keyterm-prompting.mp3"
);
const audioBlob = new Blob([await response.arrayBuffer()], { type: "audio/mp3" });

const transcription = await elevenlabs.speechToText.convert({
  file: audioBlob,
  modelId: "scribe_v2", // Model to use
  // Keyterms to prompt the model with.
  // Up to 1000 keyterms can be provided, with a maximum length of 50 characters each
  keyterms: ["ElevenLabs"],
});

console.log(transcription);
```

## Realtime streaming

Keyterm prompting is ook beschikbaar voor de [realtime Speech to Text WebSocket-API](/docs/nl/eleven-api/guides/how-to/speech-to-text/realtime/client-side-streaming). Geef de parameter `keyterms` door tijdens het verbinden.

```python
connection = await elevenlabs.speech_to_text.realtime.connect(RealtimeUrlOptions(
    model_id="scribe_v2_realtime",
    keyterms=["ElevenLabs"],
))
```

```typescript
const connection = await elevenlabs.speechToText.realtime.connect({
  modelId: "scribe_v2_realtime",
  keyterms: ["ElevenLabs"],
});
```

Wanneer je de WebSocket-API rechtstreeks gebruikt, geef je keyterms door als queryparameters:

```
wss://api.elevenlabs.io/v1/speech-to-text/realtime?model_id=scribe_v2_realtime&keyterms=ElevenLabs&keyterms=AnotherTerm
```

## Volgende stappen

#### [API-referentie](/docs/nl/api-reference/speech-to-text)

Volledige Speech to Text-API-referentie en parameters.

#### [Entiteitsdetectie](/docs/nl/eleven-api/guides/how-to/speech-to-text/batch/entity-detection)

Detecteer en label automatisch entiteiten zoals namen, datums en locaties in transcripten.