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

# Options de nombres et de langues

> **Note**
>
> **Guide pratique** · Suppose que vous avez suivi le [démarrage rapide de Speech to Text ](/docs/fr/eleven-api/guides/cookbooks/speech-to-text).

## Vue d’ensemble

[Scribe v3](/docs/fr/overview/models#scribe-v3) ajoute deux paramètres facultatifs à l’API Speech to Text par lots :

* `numbers_format` définit si les nombres de la transcription sont écrits sous forme de chiffres (`42`) ou de lettres (`quarante-deux`).
* `secondary_language_codes` répertorie les autres langues susceptibles d’être parlées dans l’audio avec `language_code`. Cela améliore la précision lorsque les intervenants alternent entre plusieurs langues.

Ces deux paramètres sont uniquement pris en charge par `scribe_v3`. L’envoi de l’un d’eux avec un autre modèle renvoie une erreur `invalid_parameters`.

> **Note**
>
> Les SDK ne proposent pas encore d’arguments typés pour ces paramètres. En Python, transmettez-les via
> `request_options`. En TypeScript, envoyez la requête avec `fetch`.

## Formater les nombres

Définissez `numbers_format` sur `digits` ou `words`. Lorsque le paramètre est omis, le modèle choisit le format.

| Valeur   | Exemple de sortie    |
| -------- | -------------------- |
| `digits` | `42`                 |
| `words`  | `quarante-deux`      |
| (omis)   | Choisi par le modèle |

```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` contrôle la manière dont le modèle transcrit les nombres. Pour modifier la façon dont les dates, les heures ou les unités sont écrites, utilisez la [modification de transcription](/docs/fr/eleven-api/guides/how-to/speech-to-text/batch/transcript-editing).

## Déclarer des langues secondaires

Définissez `language_code` sur la langue principale de l’audio et `secondary_language_codes` sur les autres langues attendues. Les deux acceptent les codes ISO-639-1 ou ISO-639-3.

`secondary_language_codes` est une liste. Répétez le champ de formulaire une fois par langue. Un tableau JSON envoyé sous forme d’une seule chaîne n’est pas accepté.

L’exemple suivant transcrit un audio en anglais contenant également de l’espagnol et du français :

```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**
>
> Les codes non reconnus dans `secondary_language_codes` sont ignorés sans erreur. Vérifiez les codes
> dans les [langues prises en charge](/docs/fr/overview/capabilities/speech-to-text#supported-languages)
> avant d’envoyer la requête.

Scribe v3 transcrit la parole dans la langue parlée. Il ne traduit pas entre les langues principales et secondaires.

## Associer à d’autres paramètres

Les deux paramètres peuvent être utilisés ensemble et avec d’autres paramètres par lots, comme `keyterms`, `diarize` et `no_verbatim`. Consultez le [prompting par termes clés](/docs/fr/eleven-api/guides/how-to/speech-to-text/batch/keyterm-prompting) afin d’orienter la transcription vers des termes précis.

## Étapes suivantes

#### [Modèles](/docs/fr/overview/models#scribe-v3)

Fonctionnalités de Scribe v3 et procédure d’upgrade depuis Scribe v2.

#### [Options de langue en temps réel](/docs/fr/eleven-api/guides/how-to/speech-to-text/realtime/language-options)

Transcrivez de l’audio en direct dans plusieurs langues avec Scribe v3 Live.