Ir para a navegação
Guias práticosSpeech to TextEm tempo real

Opções de idioma

Este guia mostra como transcrever áudio em mais de um idioma com a API de Transcrição de Voz em Tempo Real.

Guia prático · Pressupõe que você concluiu o guia de streaming do lado do cliente ou do lado do servidor.

Visão geral

Por padrão, a API em tempo real detecta o idioma do áudio automaticamente. Você pode alterar esse comportamento de três formas:

  • Defina language_code como o idioma do áudio.
  • Adicione secondary_languages para limitar a detecção de idioma a um conjunto de idiomas esperados.
  • Com o Scribe v3 Live, defina multilang_mode=true para acompanhar falantes que alternam entre idiomas durante a sessão.

O Scribe não traduz. A fala é transcrita no idioma em que foi falada.

Idiomas secundários

Passe language_code com o idioma principal e repita secondary_languages uma vez para cada idioma adicional na string de consulta. Ambos aceitam códigos ISO-639-1 ou ISO-639-3.

wss://api.elevenlabs.io/v1/speech-to-text/realtime?model_id=scribe_v3_live&language_code=en&secondary_languages=es&secondary_languages=fr

secondary_languages torna a identificação de idioma mais confiável ao limitá-la aos idiomas que você listar. Para acompanhar falantes que alternam entre idiomas durante a sessão, use o modo multilíngue.

Modo multilíngue

O modo multilíngue está disponível apenas no Scribe v3 Live (scribe_v3_live). Outros modelos rejeitam multilang_mode=true com um erro invalid_request e encerram a conexão.

Com multilang_mode=true, o Scribe v3 Live transcreve cada idioma em sua própria escrita e acompanha mudanças de idioma, inclusive no meio de uma frase.

wss://api.elevenlabs.io/v1/speech-to-text/realtime?model_id=scribe_v3_live&audio_format=pcm_16000&multilang_mode=true

O modo multilíngue tem as seguintes desvantagens:

  • Fala ao fundo que soa como outro idioma pode ser transcrita.
  • Frases curtas têm mais chance de ser transcritas incorretamente.

Os SDKs oficiais ainda não oferecem suporte a multilang_mode. Para usá-lo, conecte-se à API WebSocket diretamente.

Próximas etapas

Transcrições e estratégias de confirmação

Confirme transcrições manualmente, no silêncio ou com previsão de turno.

Opções de números e idiomas

Formate números e declare idiomas secundários para áudio gravado.