VocalStack Logo

Documentation

Obter dados de transcrição

Transcrever de um microfone ou LiveStream

Transcreva falas ao vivo de um microfone ou transmissão ao vivo

Sessões de transcrição

Monitore e gerencie o estado da transcrição com sessões

Traduzir uma transcrição

Traduza o texto transcrito para outro idioma

Transcrever áudio a partir de URL

Transcrever fala de áudio pré-gravado em um URL para texto simples

Tokens de autenticação do lado do cliente

Criar um token de autenticação temporário para solicitações do lado do cliente

Pedido e Resposta de Transcrição

Opções de solicitação e respostas comuns para todas as operações de transcrição

Transcrever e Apresentar uma Sessão Poliglota

Crie uma sessão que possa ser usada para transmitir uma transcrição ao vivo por meio de um link compartilhável público

Obter dados de transcrição

Procurar na documentação
Obtenha dados de transcrições pendentes ou concluídas. Isso inclui a linha do tempo da transcrição, palavras-chave, resumo e segmentos de parágrafo.
Você pode usar a API VocalStack para buscar dados de transcrição depois de começar a transcrever áudio com qualquer um dos seguintes métodos:
Transcrever áudio a partir de URL
Transcrever fala de áudio pré-gravado em um URL para texto simples. Os principais formatos de arquivo são suportados, incluindo MP3, WAV, FLAC e OGG.
Transcrever de um microfone ou LiveStream
Transcreva falas ao vivo de um microfone ou transmissão ao vivo. Integre-se com o Polyglot para criar um link público compartilhável para a transcrição que os usuários podem ler em qualquer idioma.
Transcrever e Apresentar uma Sessão Poliglota
Crie uma sessão que possa ser usada para transmitir uma transcrição ao vivo por meio de um link compartilhável público. Os usuários podem ler transcrições ao vivo em seu idioma preferido e até mesmo transcrições passadas quando sua sessão estiver inativa.

Obtendo todas as transcrições

Obter todas as transcrições é feito usando Transcriptions do VocalStack SDK:
JavaScript
import { Transcriptions } from '@vocalstack/js-sdk';

const sdk = new Transcriptions({ apiKey: 'YOUR-API-KEY' });
const transcriptions = await sdk.getAllTranscriptions();

transcriptions.data?.forEach((transcription) => {
  // the transcription ID (use this to get more details about the transcription)
  console.log(transcription.id);
  
  // 'waiting', 'processing', 'done', or 'error'
  console.log(transcription.status);

  // the time the transcription started
  console.log(transcription.start);

  // the time the transcription finalized
  console.log(transcription.end); 

  // the keywords associated with the transcription
  console.log(transcription.keywords);
  
  // the length of the transcription in seconds
  console.log(transcription.duration);
});

Obtendo uma única transcrição

Para obter todos os dados disponíveis para uma transcrição, devemos usar o id de tal transcrição. O id é retornado sempre que um processo de transcrição é iniciado. No entanto, também pode ser obtido olhando para todas as transcrições usando a API acima.
Para obter uma transcrição específica use Transcriptions do VocalStack SDK:
JavaScript
import { Transcriptions } from '@vocalstack/js-sdk';

const sdk = new Transcriptions({ apiKey: 'YOUR-API-KEY' });
const transcription = await sdk.getTranscription({ id: 'TRANSCRIPTION-ID' });
const data = transcription.data;

if (data) {
  // the transcription ID (use this to get more details about the transcription)
  console.log(data.id);

  // 'waiting', 'processing', 'done', or 'error'
  console.log(data.status);

  // the time the transcription started
  console.log(data.start);

  // the time the transcription finalized
  console.log(data.end);

  // the keywords associated with the transcription
  console.log(data.keywords);

  // the length of the transcription in seconds
  console.log(data.duration);

  // an object with the transcription timeline
  console.log(data.timeline);

  // a summary of the transcription
  console.log(data.summary);

  // the entire transcription in paragraph form
  console.log(data.paragraphs);
}

Transcrições pendentes

Na maioria dos cenários, você só estaria interessado em obter dados para uma única transcrição uma vez que essa transcrição tenha terminado de processar. Isso ocorre porque as transcrições são operações assíncronas que podem ter seu progresso monitorado assíncronamente onde você executa esse processo de transcrição. No entanto, se você solicitar dados de transcrição para uma transcrição que ainda está pendente, você ainda receberá todos os dados disponíveis para essa transcrição, incluindo a transcrição mais atualizada. timeline.

Transcrições completas

Uma vez que uma transcrição está completa, ela passou por pós-processamento, e neste caso os dados de transcrição também conterá valores para keywords, summary e paragraphs.

Os próximos passos

Revise o objeto de resposta retornado com cada transcrição:
Pedido e Resposta de Transcrição
Opções de solicitação e respostas comuns para todas as operações de transcrição. Use opções para configurar as configurações de transcrição.
Scroll Up