SDK JavaScript
Scribe: transcrição de voz em tempo real em JavaScript
Para uma visão geral do Scribe e seus recursos, consulte a visão geral do Speech to Text . Para guias de uso passo a passo, consulte streaming no lado do cliente .
Instalação
Use a skill de Speech to Text da ElevenLabs para transcrever áudio com seu assistente de programação com IA:
Esta biblioteca pode ser usada em qualquer projeto baseado em JavaScript. Se você usa React, considere o
hook useScribe, que oferece
gerenciamento de estado e controle de ciclo de vida integrados.
Uso
Veja um exemplo mínimo funcional que se conecta ao Scribe e registra os resultados da transcrição:
Como obter um token
O Scribe exige um token de uso único para autenticação. Crie um endpoint de API no seu servidor:
Sua chave de API da ElevenLabs é sensível. Nunca a exponha ao cliente. Sempre gere o token no servidor.
Opções de conexão
Scribe.connect() aceita opções de microfone ou opções de áudio manual. Ambas compartilham um conjunto comum de opções básicas.
Opções básicas
Opções de microfone
Passe um objeto microphone para transmitir áudio diretamente do microfone do usuário. A conexão gerencia getUserMedia e a codificação de áudio automaticamente.
Opções de áudio manual
Passe audioFormat e sampleRate para enviar dados de áudio manualmente por meio de connection.send().
Enum AudioFormat
Modo microfone
Transmita áudio diretamente do microfone do usuário:
Modo de áudio manual (transcrição de arquivo)
Transcreva arquivos de áudio pré-gravados enviando os dados de áudio manualmente:
RealtimeConnection
Scribe.connect() retorna uma instância de RealtimeConnection com os seguintes métodos.
on(event, listener)
Registre um listener de evento. Consulte Eventos para ver os tipos de evento disponíveis.
off(event, listener)
Remova um listener de evento registrado anteriormente.
send(data)
Envie dados de áudio para o Scribe (somente no modo de áudio manual).
O campo previousText só pode ser enviado no primeiro bloco de áudio de uma sessão. Enviá-lo em
blocos subsequentes resulta em erro.
commit()
Confirme manualmente a transcrição atual. Necessário apenas ao usar CommitStrategy.MANUAL.
close()
Feche a conexão WebSocket e libere recursos (stream do microfone, contexto de áudio).
Eventos
Registre listeners de evento usando connection.on(event, listener). Todos os eventos estão disponíveis como constantes no enum RealtimeEvents.
Eventos de transcrição
O tipo WordsItem contém informações de tempo por palavra:
Eventos de conexão
Eventos de erro
Todos os eventos de erro recebem { error: string }.
Estratégias de confirmação
Controle quando as transcrições são confirmadas:
Para mais detalhes, consulte Transcrições e estratégias de confirmação.
Exemplo completo
Veja um exemplo completo que transcreve áudio do microfone com uma estratégia de confirmação baseada em VAD: