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

# Opzioni per numeri e lingue

> **Note**
>
> **Guida pratica** · Presuppone che tu abbia completato la [guida introduttiva a Speech to Text ](/docs/it/eleven-api/guides/cookbooks/speech-to-text).

## Panoramica

[Scribe v3](/docs/it/overview/models#scribe-v3) aggiunge due parametri facoltativi all'API batch Speech to Text:

* `numbers_format` stabilisce se i numeri nella trascrizione vengono scritti come cifre (`42`) o in lettere (`forty-two`).
* `secondary_language_codes` elenca le altre lingue che possono essere parlate nell'audio insieme a `language_code`. Questo migliora l'accuratezza negli audio in cui gli interlocutori passano da una lingua all'altra.

Entrambi i parametri sono supportati solo da `scribe_v3`. L'invio di uno dei due con un altro modello restituisce un errore `invalid_parameters`.

> **Note**
>
> Gli SDK non dispongono ancora di argomenti tipizzati per questi parametri. In Python, passali tramite
> `request_options`. In TypeScript, invia la richiesta con `fetch`.

## Formattare i numeri

Imposta `numbers_format` su `digits` o `words`. Quando il parametro viene omesso, il modello sceglie il formato.

| Valore   | Esempio di output  |
| -------- | ------------------ |
| `digits` | `42`               |
| `words`  | `forty-two`        |
| (omesso) | Scelto dal modello |

```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` controlla il modo in cui il modello trascrive i numeri. Per altre modifiche al modo in cui vengono scritte date, orari o unità, usa la [modifica della trascrizione](/docs/it/eleven-api/guides/how-to/speech-to-text/batch/transcript-editing).

## Dichiarare lingue secondarie

Imposta `language_code` sulla lingua principale dell'audio e `secondary_language_codes` sulle altre lingue previste. Entrambi accettano codici ISO-639-1 o ISO-639-3.

`secondary_language_codes` è un elenco. Ripeti il campo del modulo una volta per ogni lingua. Un array JSON inviato come singola stringa non viene accettato.

L'esempio seguente trascrive un audio in inglese che contiene anche spagnolo e francese:

```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**
>
> I codici non riconosciuti in `secondary_language_codes` vengono ignorati senza generare un errore. Verifica i codici
> rispetto alle [lingue supportate](/docs/it/overview/capabilities/speech-to-text#supported-languages)
> prima di inviare la richiesta.

Scribe v3 trascrive il parlato nella lingua in cui viene pronunciato. Non traduce tra le lingue principali e secondarie.

## Combinare con altri parametri

Entrambi i parametri possono essere usati insieme e con altri parametri batch, come `keyterms`, `diarize` e `no_verbatim`. Consulta il [prompting dei termini chiave](/docs/it/eleven-api/guides/how-to/speech-to-text/batch/keyterm-prompting) per orientare la trascrizione verso termini specifici.

## Passaggi successivi

#### [Modelli](/docs/it/overview/models#scribe-v3)

Funzionalità di Scribe v3 e come eseguire l'upgrade da Scribe v2.

#### [Opzioni linguistiche in tempo reale](/docs/it/eleven-api/guides/how-to/speech-to-text/realtime/language-options)

Trascrivi audio dal vivo in più lingue con Scribe v3 Live.