VocalStack Logo

Documentation

Obter os datos de transcrición

Transcreba desde un micrófono ou LiveStream

Transcreba o discurso en directo desde un micrófono ou unha transmisión en directo

Sesións de transcripción

Vixiar e xestionar o estado da transcrición con sesións

Traducir unha transcrición

Traducir o texto transcrito a outro idioma

Transcreba o son desde un URL

Transcríbe a voz de audio pregrabado nun URL a texto simple

Tokens de autenticación do lado do cliente

Crear un token de autenticación temporal para as solicitudes do lado do cliente

Solicitude e resposta de transcrición

Opcións de petición e respostas comúns para todas as operacións de transcrición

Transcreba e presente unha sesión de Polyglot

Crear unha sesión que se poida usar para difundir unha transcrición en directo mediante unha ligazón pública compartible

Obter os datos de transcrición

Examinar a documentación
Obter datos de transcricións pendentes ou completadas. Isto inclúe a liña de tempo da transcrición, palabras chave, resumo e segmentos de parágrafo.
Pode usar a API VocalStack para obter os datos de transcrición unha vez que comece a transcreber o son con calquera dos seguintes métodos:
Transcreba o son desde un URL
Transcríbe a voz de audio pregrabado nun URL a texto simple. Están soportados os principais formatos de ficheiro, incluíndo MP3, WAV, FLAC e OGG.
Transcreba desde un micrófono ou LiveStream
Transcreba o discurso en directo desde un micrófono ou unha transmisión en directo. Integrar con Polyglot para crear unha ligazón pública compartible para a transcrición que os usuarios poidan ler en calquera idioma.
Transcreba e presente unha sesión de Polyglot
Crear unha sesión que se poida usar para difundir unha transcrición en directo mediante unha ligazón pública compartible. Os usuarios poden ler as transcricións en directo no idioma que prefiran, e mesmo as transcricións pasadas cando a sesión estea inactiva.

A obter todas as transcricións

Obter todas as transcricións realízase usando Transcriptions do SDK de VocalStack:
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);
});

Obter unha única transcrición

Para obter todos os datos dispoñíbeis para unha transcrición debemos usar o. id da transcrición. id devolvese cando se inicia un proceso de transcrición. Porén, tamén se pode obter mirando todas as transcricións usando a API de arriba.
Para obter unha transcrición específica use Transcriptions do SDK de VocalStack:
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);
}

Transcricións pendentes

Na maioría dos casos só lle interesaría obter datos para unha única transcrición unha vez que esa transcrición remate de procesarse. Isto é porque as transcricións son operacións asincrónicas que poden ter o seu progreso monitorizado asincrónica onde executa ese proceso de transcrición. Porén, se solicita datos de transcrición para unha transcrición que aínda está pendente, aínda así obterá todos os datos dispoñíbeis para esa transcrición, incluíndo a máis actualizada timeline.

Transcricións completadas

Unha vez completada unha transcrición, esta foi sometida a un post- procesamento, e neste caso os datos da transcrición tamén conterán valores para keywords, summary e paragraphs.

Seguintes pasos

Revisar o obxecto de resposta devolvido con cada transcrición:
Solicitude e resposta de transcrición
Opcións de petición e respostas comúns para todas as operacións de transcrición. Empregue as opcións para configurar as opcións de transcrición.
Scroll Up