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

# Opties voor getallen en talen

> **Note**
>
> **Handleiding** · Hierbij gaan we ervan uit dat je de [Speech to Text- quickstart](/docs/nl/eleven-api/guides/cookbooks/speech-to-text) hebt voltooid.

## Overzicht

[Scribe v3](/docs/nl/overview/models#scribe-v3) voegt twee optionele parameters toe aan de batch Speech to Text API:

* `numbers_format` bepaalt of getallen in het transcript als cijfers (`42`) of als woorden (`forty-two`) worden geschreven.
* `secondary_language_codes` geeft andere talen weer die naast `language_code` in de audio kunnen worden gesproken. Dit verbetert de nauwkeurigheid voor audio waarin sprekers tussen talen wisselen.

Beide parameters worden alleen ondersteund door `scribe_v3`. Als je een van beide met een ander model verstuurt, wordt de fout `invalid_parameters` geretourneerd.

> **Note**
>
> De SDK's hebben nog geen getypeerde argumenten voor deze parameters. Geef ze in Python door via
> `request_options`. Verstuur de request in TypeScript met `fetch`.

## Getallen opmaken

Stel `numbers_format` in op `digits` of `words`. Wanneer de parameter wordt weggelaten, kiest het model de notatie.

| Waarde       | Voorbeelduitvoer       |
| ------------ | ---------------------- |
| `digits`     | `42`                   |
| `words`      | `forty-two`            |
| (weggelaten) | Gekozen door het model |

```python maxLines=0 {19-24}
import os
from io import BytesIO

import requests
from dotenv import load_dotenv
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/audio/marketing/nicole.mp3"
audio_data = BytesIO(requests.get(audio_url).content)

transcription = elevenlabs.speech_to_text.convert(
    file=audio_data,
    model_id="scribe_v3",
    request_options={
        "additional_body_parameters": {
            "numbers_format": "digits",
        },
    },
)

print(transcription.text)
```

```typescript maxLines=0 {10-11}
import "dotenv/config";

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

const form = new FormData();
form.append("file", audioBlob, "nicole.mp3");
form.append("model_id", "scribe_v3");
form.append("numbers_format", "digits");

const response = await fetch("https://api.elevenlabs.io/v1/speech-to-text", {
  method: "POST",
  headers: { "xi-api-key": process.env.ELEVENLABS_API_KEY! },
  body: form,
});

const transcription = await response.json();
console.log(transcription.text);
```

`numbers_format` bepaalt hoe het model getallen transcribeert. Gebruik [transcriptbewerking](/docs/nl/eleven-api/guides/how-to/speech-to-text/batch/transcript-editing) voor andere wijzigingen in de schrijfwijze van datums, tijden of eenheden.

## Secundaire talen opgeven

Stel `language_code` in op de hoofdtaal van de audio en `secondary_language_codes` op de andere talen die je verwacht. Beide accepteren ISO-639-1- of ISO-639-3-codes.

`secondary_language_codes` is een lijst. Herhaal het formulierveld eenmaal per taal. Een JSON-array die als één tekenreeks wordt verstuurd, wordt niet geaccepteerd.

In het volgende voorbeeld wordt Engelse audio getranscribeerd die ook Spaans en Frans bevat:

```python maxLines=0 {4-9}
transcription = elevenlabs.speech_to_text.convert(
    file=audio_data,
    model_id="scribe_v3",
    language_code="en",
    request_options={
        "additional_body_parameters": {
            "secondary_language_codes": ["es", "fr"],
        },
    },
)
```

```typescript maxLines=0 {4-7}
const form = new FormData();
form.append("file", audioBlob, "recording.mp3");
form.append("model_id", "scribe_v3");
form.append("language_code", "en");
for (const code of ["es", "fr"]) {
  form.append("secondary_language_codes", code);
}

const response = await fetch("https://api.elevenlabs.io/v1/speech-to-text", {
  method: "POST",
  headers: { "xi-api-key": process.env.ELEVENLABS_API_KEY! },
  body: form,
});
```

> **Warning**
>
> Niet-herkende codes in `secondary_language_codes` worden zonder foutmelding overgeslagen. Controleer de codes
> aan de hand van de [ondersteunde talen](/docs/nl/overview/capabilities/speech-to-text#supported-languages)
> voordat je de request verstuurt.

Scribe v3 transcribeert spraak in de taal waarin deze wordt gesproken. Het vertaalt niet tussen de hoofd- en secundaire talen.

## Combineren met andere parameters

Beide parameters kunnen samen en met andere batchparameters worden gebruikt, zoals `keyterms`, `diarize` en `no_verbatim`. Bekijk [keyterm prompting](/docs/nl/eleven-api/guides/how-to/speech-to-text/batch/keyterm-prompting) om transcriptie te sturen naar specifieke termen.

## Volgende stappen

#### [Modellen](/docs/nl/overview/models#scribe-v3)

Functies van Scribe v3 en hoe je upgradet vanaf Scribe v2.

#### [Realtime taalopties](/docs/nl/eleven-api/guides/how-to/speech-to-text/realtime/language-options)

Transcribeer live-audio in meer dan één taal met Scribe v3 Live.