VocalStack Logo

Documentation

Çeviri Verilerini Al

Beklenen veya tamamlanmış transkriplerden veri al

Çeviri Oturumu

Seanslarla transkripsiyon durumunu izle ve yönet

Çeviri

Tercüme edilen metni başka bir dile çevir

URL'den Ses Yazdır

URL'de önceden kaydedilmiş seslerden konuşmayı açık metin olarak kopyala

İstemci Tarafından Kimlik Doğrulama Tokenleri

İstemci tarafı talepleri için geçici kimlik doğrulama işareti oluştur

Çeviri İsteği ve Cevap

Tüm çeviri işlemleri için ortak isteme seçenekleri ve cevaplar

Bir Polyglot oturumu kopyala ve sunun

Halka açık paylaşılabilir bir bağlantı üzerinden canlı bir transkrip yayınlanması için kullanılabilecek bir oturum oluşturun

Mikrofon veya LiveStream'den transkrip

Belgeleri Görüntüle
Mikrofon veya canlı yayından canlı konuşmayı kaydedin. Polyglot ile entegre olun ve kullanıcıların herhangi bir dilde okuyabileceği kamuya açık paylaşılabilir bir metin bağlantısı oluşturun.
Bir mikrofondan kopyalamak için, sürekli olarak ses veri akışı paketlerini VocalStack API'ye göndermeliyiz.
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 } });
Ses akışı verilerini almak, transkripsiyon işlemini gerçekleştirmek istediğiniz çevreye bağlı olarak farklılık gösterecektir. Bunu nasıl yapacağınız için birkaç örnek vereceğim:
NextJS'de cihazınızdan ses verilerini alabilen bir paket yüklemelisiniz, ki bu da VocalStack API'sine yönlendirebilirsiniz. İşte bir örnek:
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();
Web tarayıcısında şunları kullanabilirsiniz: MediaRecorderName API aşağıdaki örnekte görüldüğü gibi. (Aynı zamanda gibi bir paket kullanmak iyi bir fikir olabilir.) recordrtc which improves browser compatibility)
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);
Web istemcilerinde VocalStack API'ye erişmek için bir kimlik doğrulama işareti kullanmanız gerektiğini unutmayın:
İstemci Tarafından Kimlik Doğrulama Tokenleri
İstemci tarafı talepleri için geçici kimlik doğrulama işareti oluştur. API anahtarlarınızı açık bırakmadan web tarayıcılarında API taleplerini güvenli bir şekilde uygulayın.
VocalStack API, Youtube Live, Facebook Live ve Twitch gibi kaynaklar da dahil olmak üzere herhangi bir HLS LiveStream URL'yi kopyalamak için kullanılabilir. Akışın URL'sinin bir. .m3u8 geçerli bir HLS (HTTP Live Streaming) müzik listesi dosyasını temsil eden dosya uzantısı.
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 });
Polyglot ile canlı metin çevirilerini birleştirmek, bir. polyglot_id transkripsiyon isteğine seçenek, yukarıdaki örneklerde gösterildiği gibi.
Polyglot, metinlerinizle ilişkili halka açık paylaşılabilir bir bağlantı oluşturur (bu bağlantı şifre ile korunabilir):
  • Kullanıcılar linki kullanarak gerçek zamanlı olarak transkripinizi okuyabilirler.
  • Kullanıcılar, gerçek zamanlı olarak metin çevirisini okumak için dile seçebilirler.
  • Kullanıcılar daha sonraki bir zamanda transkripinizi okuyabilir ve diğer tüm transkripler özel Polyglot oturumu ile entegre olabilir.
VocalStack API'sini kullanmak ve VocalStack tarafından sağlanan bir kullanıcı arayüzü yerine kendi beyaz etiketli kullanıcı arayüzünüzü uygulamak için hoş geldiniz. Eğer öyleyse, bunu duymak isteriz., böylece ürünümüzü nasıl daha iyi hale getireceğimizi öğrenebiliriz!
Polyglot'un nasıl çalıştığını öğrenin. vocalstack.com/polyglot.
Bir Polyglot oturumu kopyala ve sunun
Halka açık paylaşılabilir bir bağlantı üzerinden canlı bir transkrip yayınlanması için kullanılabilecek bir oturum oluşturun. Kullanıcılar tercih ettikleri dilde canlı transkripleri ve hatta oturumunuz aktif olmadığında geçmiş transkripleri okuyabilirler.
Çeviri Verilerini Al
Beklenen veya tamamlanmış transkriplerden veri al. Bu, transkripsiyon zaman çizgisi, anahtar kelimeler, özet ve paragraf bölümlerini içerir.
İstemci Tarafından Kimlik Doğrulama Tokenleri
İstemci tarafı talepleri için geçici kimlik doğrulama işareti oluştur. API anahtarlarınızı açık bırakmadan web tarayıcılarında API taleplerini güvenli bir şekilde uygulayın.
Scroll Up