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

# Optionen für Zahlen und Sprachen

> **Note**
>
> **Anleitung** · Setzt voraus, dass Sie den [Speech to Text- Schnellstart](/docs/de/eleven-api/guides/cookbooks/speech-to-text) abgeschlossen haben.

## Überblick

[Scribe v3](/docs/de/overview/models#scribe-v3) ergänzt die Batch-Speech to Text-API um zwei optionale Parameter:

* `numbers_format` legt fest, ob Zahlen im Transkript als Ziffern (`42`) oder als Wörter (`forty-two`) geschrieben werden.
* `secondary_language_codes` listet weitere Sprachen auf, die neben `language_code` im Audio gesprochen werden können. Das verbessert die Genauigkeit bei Audio, in dem Sprecher zwischen Sprachen wechseln.

Beide Parameter werden nur von `scribe_v3` unterstützt. Wenn einer davon mit einem anderen Modell gesendet wird, wird ein Fehler `invalid_parameters` zurückgegeben.

> **Note**
>
> Die SDKs verfügen noch nicht über typisierte Argumente für diese Parameter. Übergeben Sie sie in Python über
> `request_options`. Senden Sie die Anfrage in TypeScript mit `fetch`.

## Zahlen formatieren

Setzen Sie `numbers_format` auf `digits` oder `words`. Wenn der Parameter ausgelassen wird, wählt das Modell das Format.

| Wert          | Beispielausgabe    |
| ------------- | ------------------ |
| `digits`      | `42`               |
| `words`       | `forty-two`        |
| (ausgelassen) | Vom Modell gewählt |

```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` steuert, wie das Modell Zahlen transkribiert. Für andere Änderungen an der Schreibweise von Daten, Zeiten oder Einheiten verwenden Sie die [Transkriptbearbeitung](/docs/de/eleven-api/guides/how-to/speech-to-text/batch/transcript-editing).

## Sekundäre Sprachen angeben

Setzen Sie `language_code` auf die Hauptsprache des Audios und `secondary_language_codes` auf die weiteren erwarteten Sprachen. Beide akzeptieren ISO-639-1- oder ISO-639-3-Codes.

`secondary_language_codes` ist eine Liste. Wiederholen Sie das Formularfeld einmal pro Sprache. Ein JSON-Array, das als einzelne Zeichenfolge gesendet wird, wird nicht akzeptiert.

Das folgende Beispiel transkribiert englisches Audio, das auch Spanisch und Französisch enthält:

```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**
>
> Nicht erkannte Codes in `secondary_language_codes` werden ohne Fehler übersprungen. Prüfen Sie die Codes
> anhand der [unterstützten Sprachen](/docs/de/overview/capabilities/speech-to-text#supported-languages),
> bevor Sie die Anfrage senden.

Scribe v3 transkribiert Gesprochenes in der Sprache, in der es gesprochen wird. Es übersetzt nicht zwischen Haupt- und Nebensprachen.

## Mit anderen Parametern kombinieren

Beide Parameter können zusammen und mit anderen Batch-Parametern verwendet werden, etwa `keyterms`, `diarize` und `no_verbatim`. Unter [Keyterm Prompting](/docs/de/eleven-api/guides/how-to/speech-to-text/batch/keyterm-prompting) erfahren Sie, wie Sie die Transkription auf bestimmte Begriffe ausrichten.

## Nächste Schritte

#### [Modelle](/docs/de/overview/models#scribe-v3)

Funktionen von Scribe v3 und Upgrade von Scribe v2.

#### [Echtzeit-Sprachoptionen](/docs/de/eleven-api/guides/how-to/speech-to-text/realtime/language-options)

Transkribieren Sie Live-Audio mit Scribe v3 Live in mehreren Sprachen.