VocalStack Logo

Documentation

Získání dat přepisu

Přepis z mikrofonu nebo LiveStream

Přepisujte živou řeč z mikrofonu nebo živého streamu

Přepisovací sezení

Monitorování a správa stavu přepisu pomocí relací

Přeložit přepis

Přeložit přepsaný text do jiného jazyka

Přepisovat zvuk z URL

Přepis řeči z předem nahraného zvuku v URL do prostého textu

Tokeny ověřování na straně klienta

Vytvořit dočasný token ověření pro požadavky na straně klienta

Žádost o přepis a odpověď

Společné možnosti požadavků a odpovědí pro všechny operace přepisu

Přepisujte a prezentujte polyglot session

Vytvořte relaci, kterou lze použít k vysílání živého přepisu prostřednictvím veřejného sdíleného odkazu

Získání dat přepisu

Procházet dokumentaci
Získejte data z čekajících nebo dokončených přepisů. To zahrnuje časovou osu přepisu, klíčová slova, souhrn a segmenty odstavců.
Po zahájení přepisu zvuku můžete k načtení dat přepisu použít rozhraní VocalStack API některou z následujících metod:
Přepisovat zvuk z URL
Přepis řeči z předem nahraného zvuku v URL do prostého textu. Hlavní formáty souborů jsou podporovány, včetně MP3, WAV, FLAC a OGG.
Přepis z mikrofonu nebo LiveStream
Přepisujte živou řeč z mikrofonu nebo živého streamu. Integrujte s Polyglotem a vytvořte veřejný sdílitelný odkaz na přepis, který si uživatelé mohou přečíst v jakémkoli jazyce.
Přepisujte a prezentujte polyglot session
Vytvořte relaci, kterou lze použít k vysílání živého přepisu prostřednictvím veřejného sdíleného odkazu. Uživatelé si mohou přečíst živé přepisy ve svém preferovaném jazyce a dokonce i minulé přepisy, když je relace neaktivní.

Získání všech přepisů

Získání všech přepisů je provedeno pomocí Transcriptions z 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);
});

Získání jednoho přepisu

Abychom získali všechna data dostupná pro přepis, musíme použít. id z tohoto přepisu. id je vrácen pokaždé, když je transkripční proces poprvé zahájen. Nicméně, může být také získána při pohledu na všechny přepisy pomocí API výše.
Chcete-li získat konkrétní přepis, použijte Transcriptions z 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);
}

Čekající na přepisy

Ve většině případů by vás zajímalo získat data pro jeden přepis pouze poté, co tento přepis dokončí zpracování. Je to proto, že přepisy jsou asynchronní operace, jejichž průběh lze sledovat asynchronně, kdekoli tento přepisový proces provádíte. Pokud však požádáte o přepisová data pro přepis, který je stále v procesu, stále obdržíte všechna data dostupná pro tento přepis, včetně nejnovějších dat. timeline.

Dokončené přepisy

Jakmile je přepis dokončen, prošel post-zpracováním, a v tomto případě budou přepisová data obsahovat také hodnoty pro. keywords, summary a paragraphs.

Další kroky

Zkontrolujte objekt odpovědi vrácený s každým přepisem:
Žádost o přepis a odpověď
Společné možnosti požadavků a odpovědí pro všechny operace přepisu. Pomocí možností můžete konfigurovat nastavení přepisu.
Scroll Up