VocalStack Logo

Documentation

Obtén les dades de transcripció

Transcriviu des d'un micròfon o LiveStream

Transcriviu el discurs en directe des d'un micròfon o una transmissió en directe

Sessions de transcripció

Monitoritzeu i gestioneu l'estat de la transcripció amb sessions

Tradueix una transcripció

Tradueix el text transcrit a un altre idioma

Transcriu àudio des d' URL

Transcriu la veu d'àudio preenregistrat en un URL a text pla

Tokens d' autenticació del client

Crea un token d' autenticació temporal per a peticions del client

Petició i resposta de transcripció

Opcions de petició i respostes comunes per a totes les operacions de transcripció

Transcriviu i presenteu una sessió poliglota

Crea una sessió que es pot usar per a emetre una transcripció en directe a través d' un enllaç públic compartible

Obtén les dades de transcripció

Navega per la documentació
Obtén dades de les transcripcions pendents o completades. Això inclou la línia de temps de transcripció, paraules clau, resum i segments de paràgraf.
Podeu usar l' API VocalStack per a recuperar les dades de transcripció una vegada que hàgiu començat a transcriure l' àudio amb qualsevol dels següents mètodes:
Transcriu àudio des d' URL
Transcriu la veu d'àudio preenregistrat en un URL a text pla. S'admeten els principals formats de fitxer, incloent MP3, WAV, FLAC i OGG.
Transcriviu des d'un micròfon o LiveStream
Transcriviu el discurs en directe des d'un micròfon o una transmissió en directe. Integrar amb Polyglot per crear un enllaç públic compartible per a la transcripció que els usuaris puguin llegir en qualsevol idioma.
Transcriviu i presenteu una sessió poliglota
Crea una sessió que es pot usar per a emetre una transcripció en directe a través d' un enllaç públic compartible. Els usuaris poden llegir les transcripcions en viu en el seu idioma preferit, i fins i tot les transcripcions passades quan la vostra sessió està inactiva.

S' estan obtenint totes les transcripcions

Obtenir totes les transcripcions es fa usant Transcriptions del 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);
});

Obtenció d' una transcripció única

Per obtenir totes les dades disponibles per a una transcripció hem d' usar el id d'aquesta transcripció. id es retorna quan s'inicia un procés de transcripció. No obstant això, també es pot obtenir mirant totes les transcripcions utilitzant l'API anterior.
Per obtenir una transcripció específica, useu Transcriptions del 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);
}

Transcripcions pendents

En la majoria dels escenaris només us interessaria obtenir dades per a una sola transcripció una vegada que aquesta transcripció hagi acabat de processar- se. Això és perquè les transcripcions són operacions asíncrones que poden tenir el seu progrés controlat aixíncronament on s'executa aquest procés de transcripció. Tanmateix, si demaneu dades de transcripció per a una transcripció que encara està pendent, encara obtindreu totes les dades disponibles per a aquesta transcripció, incloent- hi la més actualitzada timeline.

Transcripcions completades

Una vegada que una transcripció està completa, ha passat per un post- processament, i en aquest cas les dades de transcripció també contindran valors per a keywords, summary i paragraphs.

Passos següents

Revisa l' objecte de resposta retornat amb cada transcripció:
Petició i resposta de transcripció
Opcions de petició i respostes comunes per a totes les operacions de transcripció. Useu les opcions per a configurar els paràmetres de transcripció.
Scroll Up