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

# Podpowiedzi kluczowych terminów

> **Note**
>
> **Przewodnik krok po kroku** · Zakłada, że ukończyłeś [szybki start Speech to Text ](/docs/pl/eleven-api/guides/cookbooks/speech-to-text).

## Omówienie

> **Warning**
>
> Podpowiedzi kluczowych terminów są dostępne w Scribe v2, Scribe v2 Medical (batch) i Scribe v2 Realtime
> oraz są dodatkowo płatne. Szczegółowe informacje znajdziesz na [stronie cen API](https://elevenlabs.io/pricing?price.section=speech_to_text\&price.sections=speech_to_text,speech_to_text#pricing-table).

Podpowiedzi kluczowych terminów to funkcja, która pozwala wyróżniać słowa lub frazy, aby zwiększyć szansę, że model je zapisze. Jest to przydatne przy transkrypcji konkretnych słów lub zdań rzadko występujących w audio, takich jak nazwy produktów, imiona czy inne określone terminy. Kluczowe terminy są skuteczniejsze niż faworyzowane słowa kluczowe lub słowniki użytkownika oferowane przez inne modele, ponieważ model korzysta z kontekstu, by zdecydować, czy zapisać dany termin.

|                                  | Batch (Scribe v2 / Scribe v2 Medical) | Realtime (Scribe v2 Realtime) |
| -------------------------------- | ------------------------------------- | ----------------------------- |
| Maks. liczba kluczowych terminów | 1000                                  | 50                            |
| Maks. liczba znaków na termin    | 50                                    | 20                            |

W transkrypcji batch każdy kluczowy termin może też zawierać maksymalnie 5 słów.

Na przykład jeśli nazwa twojej firmy nie jest popularnym wyrażeniem albo ma nietypową pisownię czy wymowę, możesz użyć kluczowych terminów, aby model poprawnie ją zapisał. Posłuchaj poniższego audio:

<elevenlabs-audio-player audio-title="Przykład nazwy firmy" audio-src="https://storage.googleapis.com/eleven-public-cdn/documentation_assets/audio/stt-keyterm-prompting.mp3" />

Bez podpowiedzi kluczowych terminów model może zapisać to jako:

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

W tym przypadku używa niewłaściwego zapisu nazwy firmy. Dzięki podpowiedziom kluczowych terminów możesz zapewnić poprawną pisownię i styl:

```
I work at ElevenLabs.
```

### Kontekst

Model potrafi wykorzystać kontekst, aby określić, czy termin powinien zostać zapisany. Po podaniu kluczowego terminu „ElevenLabs” powyższe audio zostanie transkrybowane zgodnie z oczekiwaniami, ale model nadal poprawnie przetranskrybuje poniższy przykład na podstawie kontekstu:

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

Co daje następującą transkrypcję:

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

## Transkrypcja batch

Podpowiedzi kluczowych terminów są zintegrowane z API Speech to Text w trybie batch: przekaż parametr `keyterms` do metody `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);
```

## Przesyłanie strumieniowe w czasie rzeczywistym

Podpowiedzi kluczowych terminów są też dostępne w [API WebSocket Speech to Text w czasie rzeczywistym](/docs/pl/eleven-api/guides/how-to/speech-to-text/realtime/client-side-streaming). Przekaż parametr `keyterms` podczas łączenia.

```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"],
});
```

Gdy używasz API WebSocket bezpośrednio, przekaż kluczowe terminy jako parametry zapytania:

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

## Kolejne kroki

#### [Dokumentacja API](/docs/pl/api-reference/speech-to-text)

Pełna dokumentacja API Speech to Text i parametrów.

#### [Wykrywanie encji](/docs/pl/eleven-api/guides/how-to/speech-to-text/batch/entity-detection)

Automatycznie wykrywaj i oznaczaj w transkrypcjach encje, takie jak imiona, daty i lokalizacje.