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

# Opcje liczb i języków

> **Note**
>
> **Poradnik** · Zakłada, że masz już za sobą [krótki przewodnik po Speech to Text ](/docs/pl/eleven-api/guides/cookbooks/speech-to-text).

## Omówienie

[Scribe v3](/docs/pl/overview/models#scribe-v3) dodaje dwa opcjonalne parametry do API Speech to Text dla batch:

* `numbers_format` określa, czy liczby w transkrypcji są zapisywane cyframi (`42`), czy słownie (`forty-two`).
* `secondary_language_codes` zawiera inne języki, które mogą być używane w audio obok `language_code`. Zwiększa to dokładność w audio, gdzie mówcy przełączają się między językami.

Oba parametry obsługuje tylko `scribe_v3`. Wysłanie któregokolwiek z nich z innym modelem zwraca błąd `invalid_parameters`.

> **Note**
>
> SDK nie mają jeszcze typowanych argumentów dla tych parametrów. W Pythonie przekaż je przez
> `request_options`. W TypeScript wyślij żądanie przez `fetch`.

## Formatowanie liczb

Ustaw `numbers_format` na `digits` lub `words`. Gdy parametr zostanie pominięty, format wybiera model.

| Wartość     | Przykładowy wynik   |
| ----------- | ------------------- |
| `digits`    | `42`                |
| `words`     | `forty-two`         |
| (pominięto) | Wybrany przez 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` określa sposób transkrypcji liczb przez model. Aby zmienić sposób zapisu dat, godzin lub jednostek, użyj [edycji transkrypcji](/docs/pl/eleven-api/guides/how-to/speech-to-text/batch/transcript-editing).

## Określanie dodatkowych języków

Ustaw `language_code` na główny język audio, a `secondary_language_codes` na inne oczekiwane języki. Oba akceptują kody ISO-639-1 lub ISO-639-3.

`secondary_language_codes` to lista. Powtórz pole formularza dla każdego języka. Tablica JSON wysłana jako pojedynczy ciąg nie jest akceptowana.

Poniższy przykład transkrybuje angielskie audio, które zawiera też hiszpański i francuski:

```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**
>
> Nierozpoznane kody w `secondary_language_codes` są pomijane bez błędu. Przed wysłaniem żądania sprawdź
> kody na liście [obsługiwanych języków](/docs/pl/overview/capabilities/speech-to-text#supported-languages).

Scribe v3 transkrybuje mowę w języku, w którym jest wypowiadana. Nie tłumaczy między językiem głównym a dodatkowymi językami.

## Łączenie z innymi parametrami

Oba parametry można stosować razem i z innymi parametrami batch, takimi jak `keyterms`, `diarize` i `no_verbatim`. Zobacz [podpowiadanie kluczowych terminów](/docs/pl/eleven-api/guides/how-to/speech-to-text/batch/keyterm-prompting), aby ukierunkować transkrypcję na konkretne terminy.

## Kolejne kroki

#### [Modele](/docs/pl/overview/models#scribe-v3)

Funkcje Scribe v3 i sposób aktualizacji z Scribe v2.

#### [Opcje językowe realtime](/docs/pl/eleven-api/guides/how-to/speech-to-text/realtime/language-options)

Transkrybuj audio na żywo w więcej niż jednym języku z Scribe v3 Live.