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

# Opções de números e idiomas

> **Note**
>
> **Guia prático** · Pressupõe que você concluiu o [guia de início rápido do Speech to Text ](/docs/pt/eleven-api/guides/cookbooks/speech-to-text).

## Visão geral

O [Scribe v3](/docs/pt/overview/models#scribe-v3) adiciona dois parâmetros opcionais à API de Speech to Text em lote:

* `numbers_format` define se os números na transcrição são escritos como algarismos (`42`) ou por extenso (`quarenta e dois`).
* `secondary_language_codes` lista outros idiomas que podem ser falados no áudio junto com `language_code`. Isso melhora a precisão em áudios nos quais os falantes alternam entre idiomas.

Ambos os parâmetros são compatíveis apenas com `scribe_v3`. Enviar qualquer um deles com outro modelo retorna um erro `invalid_parameters`.

> **Note**
>
> Os SDKs ainda não têm argumentos tipados para esses parâmetros. Em Python, passe-os por
> `request_options`. Em TypeScript, envie a solicitação com `fetch`.

## Formatar números

Defina `numbers_format` como `digits` ou `words`. Quando o parâmetro é omitido, o modelo escolhe o formato.

| Valor     | Exemplo de saída      |
| --------- | --------------------- |
| `digits`  | `42`                  |
| `words`   | `quarenta e dois`     |
| (omitido) | Escolhido pelo modelo |

```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` controla como o modelo transcreve números. Para outras alterações na forma como datas, horários ou unidades são escritos, use a [edição de transcrições](/docs/pt/eleven-api/guides/how-to/speech-to-text/batch/transcript-editing).

## Declarar idiomas secundários

Defina `language_code` como o idioma principal do áudio e `secondary_language_codes` como os outros idiomas esperados. Ambos aceitam códigos ISO-639-1 ou ISO-639-3.

`secondary_language_codes` é uma lista. Repita o campo do formulário uma vez para cada idioma. Uma matriz JSON enviada como uma única string não é aceita.

O exemplo a seguir transcreve áudio em inglês que também contém espanhol e francês:

```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**
>
> Códigos não reconhecidos em `secondary_language_codes` são ignorados sem retornar erro. Verifique os códigos
> nos [idiomas compatíveis](/docs/pt/overview/capabilities/speech-to-text#supported-languages)
> antes de enviar a solicitação.

O Scribe v3 transcreve a fala no idioma em que ela é falada. Ele não traduz entre os idiomas principal e secundários.

## Combine com outros parâmetros

Ambos os parâmetros podem ser usados juntos e com outros parâmetros em lote, como `keyterms`, `diarize` e `no_verbatim`. Consulte a [sugestão de termos-chave](/docs/pt/eleven-api/guides/how-to/speech-to-text/batch/keyterm-prompting) para direcionar a transcrição a termos específicos.

## Próximas etapas

#### [Modelos](/docs/pt/overview/models#scribe-v3)

Recursos do Scribe v3 e como fazer upgrade do Scribe v2.

#### [Opções de idioma em tempo real](/docs/pt/eleven-api/guides/how-to/speech-to-text/realtime/language-options)

Transcreva áudio ao vivo em mais de um idioma com o Scribe v3 Live.