Documentation

Pridobi podatke o prepisu

Pridobite podatke iz čakajočih ali dokončanih prepisov

Seje za prepisovanje

Spremljajte in upravljajte stanje prepisa s sejami

Prevedi prepis

Prevedite prepisano besedilo v drug jezik

Prepisovanje zvoka iz URL-ja

Prepis govora iz predhodno posnetega zvoka v URL v navadno besedilo

Žetoni za preverjanje pristnosti na strani odjemalca

Ustvarite začasni žeton za preverjanje pristnosti za zahteve na strani odjemalca

Zahteva za prepis in odgovor

Skupne možnosti zahteve in odzivi za vse postopke prepisovanja

Prepis in predstavitev poliglotske seje

Ustvarite sejo, ki jo lahko uporabite za oddajanje prepisa v živo prek javne povezave za skupno rabo

Prepis iz mikrofona ali LiveStream

Brskanje po dokumentaciji
Prepisujte govor v živo iz mikrofona ali pretoka v živo. Integrirajte s Polyglotom, da ustvarite javno povezavo za deljenje prepisa, ki jo lahko uporabniki berejo v kateremkoli jeziku.
Za prepisovanje iz mikrofona moramo nenehno pošiljati pakete zvočnih podatkov v VocalStack API.
JavaScript
import { LiveTranscription } from '@vocalstack/js-sdk'; const sdk = new LiveTranscription({ apiKey: 'YOUR-API-KEY' }); const stream = await sdk.connect({ // Optional: Integrate this stream with a Polyglot session polyglot_id: 'YOUR-POLYGLOT-SESSION-ID', // Optional: language of the speech spoken // (this can be used to improve the transcription accuracy) language: 'en', // Optional: Translate the transcription to these languages translations: ['de'], // Optional: Stop the stream after this many seconds of inactivity timeout_period_s: 60, // Optional: Hard stop the stream after this many seconds max_duration_s: 300, }); // Start the stream stream.start(); // Get audio data from a microphone and send it to the stream // stream.sendBuffer(buffer); // *** This is a placeholder for the actual implementation *** // Manually stop the stream (in this example, after 60 seconds) // If max_duration_s is set, stopping the stream is optional setTimeout(() => stream.stop(), 60000); // Listen for stream transcription data stream.onData((response) => { const { status, data } = response; console.log(status); // 'waiting', 'processing', 'done', 'stopping' or 'error' if (data) { console.log(data.timeline); // an object with the transcription timeline } if (status === 'done') { console.log(data.summary); // a summary of the transcription console.log(data.keywords); // an array of keywords console.log(data.paragraphs); // the entire transcription in paragraph form } });
Pridobivanje podatkov o avdio toku se bo razlikovalo glede na okolje, v katerem želite izvesti operacijo prepisovanja. Tukaj je nekaj primerov, kako lahko to storite:
V NextJS-u morate namestiti paket, ki lahko pridobi zvočne podatke iz vaše naprave, ki jih lahko nato posredujete VocalStack API-ju. Tukaj je primer:
JavaScript
const mic = require('mic'); // Create a new instance of the microphone utility const micInstance = mic(); // Get the audio input stream const micStream = micInstance.getAudioStream(); // Capture the audio data from the microphone micStream.on('data', (data) => { stream.sendBuffer(data); // send the buffer data to the VocalStack API }); // Start capturing audio from the microphone micInstance.start();
V spletnem brskalniku boste morda želeli uporabiti. MediaRecorderName API, kot je prikazano v naslednjem primeru (morda je dobra ideja uporabiti tudi paket, kot je recordrtc , ki izboljšuje združljivost brskalnika)
JavaScript
// Request access to the microphone const mediaStream = await navigator.mediaDevices.getUserMedia({ audio: true }); // Create a MediaRecorder instance to capture audio data const mediaRecorder = new MediaRecorder(mediaStream); // Event handler to process audio data packets mediaRecorder.ondataavailable = async (event) => { const blob = event.data; // this is the audio packet (Blob) const buffer = await blob.arrayBuffer(); // convert the Blob to a Buffer stream.sendBuffer(buffer); // send the buffer data to the VocalStack API }; // Start capturing audio, and send it to the stream every second mediaRecorder.start(1000);
Upoštevajte, da boste za dostop do VocalStack API na spletnih odjemalcih morali uporabiti žeton za preverjanje pristnosti:
Žetoni za preverjanje pristnosti na strani odjemalca
Ustvarite začasni žeton za preverjanje pristnosti za zahteve na strani odjemalca. Varno izvajajte zahteve API v spletnih brskalnikih, ne da bi razkrili svoje ključe API.
VocalStack API se lahko uporablja za prepisovanje katerega koli HLS LiveStream URL, vključno z viri, kot so Youtube Live, Facebook Live in Twitch. Upoštevajte, da mora biti URL toka. .m3u8 je pripona datoteke, ki predstavlja veljavno datoteko seznama predvajanja HLS (HTTP Live Streaming).
JavaScript
import { LiveTranscription } from '@vocalstack/js-sdk'; const sdk = new LiveTranscription({ apiKey: 'YOUR-API-KEY' }); const stream = await sdk.connect({ // must be a valid HLS streaming protocol livestream_url: 'http://a.files.bbci.co.uk/media/live/manifesto/audio/simulcast/hls/nonuk/sbr_low/ak/bbc_world_service.m3u8', // The rest of these options are the same as for microphone live transcriptons }); stream.start(); stream.onData((response) => { // The response object is the same as the one // returned by microphone transcriptions });
Integracija prepisov v živo s Polyglotom je tako preprosta kot dodajanje. poliglot_id možnost za zahtevo za prepis, kot je prikazano v zgornjih primerih.
Polyglot ustvari javno povezavo, ki jo lahko delite z drugimi in je povezana z vašimi prepisi (povezava je lahko zaščitena z geslom):
  • Uporabniki lahko preberejo vaš prepis v realnem času s povezavo.
  • Uporabniki lahko izberejo jezik, v katerem želijo prebrati prepis v realnem času.
  • Uporabniki lahko preberejo vaš prepis kasneje, vse druge prepise pa integrirate v vašo posebno Polyglot sejo.
Vabljeni ste, da uporabite VocalStack API in implementirate svoj lasten beli UI namesto uporabe tistega, ki ga zagotavlja VocalStack. Mi bi radi slišali o tem, če to storite, tako da se lahko naučimo, kako izboljšati naš izdelek!
Preberite več o tem, kako Polyglot deluje na. Na voljo na vocalstack.com/polyglot.
Prepis in predstavitev poliglotske seje
Ustvarite sejo, ki jo lahko uporabite za oddajanje prepisa v živo prek javne povezave za skupno rabo. Uporabniki lahko berejo prepis v živo v svojem želenem jeziku in celo pretekle prepise, ko je vaša seja neaktivna.
Pridobi podatke o prepisu
Pridobite podatke iz čakajočih ali dokončanih prepisov. To vključuje časovnico prepisa, ključne besede, povzetek in segmente odstavkov.
Žetoni za preverjanje pristnosti na strani odjemalca
Ustvarite začasni žeton za preverjanje pristnosti za zahteve na strani odjemalca. Varno izvajajte zahteve API v spletnih brskalnikih, ne da bi razkrili svoje ključe API.
Scroll Up