JavaScript Speech to Text API Quickstart

// Step 1: Install axios and form-data
// npm install axios form-data

const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');

const API_URL = 'https://yourvoic.com/api/v1/transcription/sync';
const API_KEY = 'YOURVOIC_API_KEY'; // Replace with key from yourvoic.com dashboard

async function transcribeAudioFile(filePath) {
  try {
    const form = new FormData();
    form.append('file', fs.createReadStream(filePath));
    form.append('model', 'cipher_max');       // Options: "cipher_fast" or "cipher_max"
    form.append('language', 'hi');            // Language code: "hi", "en", "ta", "te", "auto"
    form.append('response_format', 'verbose_json'); // Speaker diarization & timestamps
    form.append('diarization', 'true');

    console.log('Sending audio payload to YourVoic Speech to Text API...');

    const response = await axios.post(API_URL, form, {
      headers: {
        ...form.getHeaders(),
        'Authorization': `Bearer ${API_KEY}`
      }
    });

    console.log('\n=== Transcription Result ===');
    console.log('Transcript Text:', response.data.text);
    console.log('\n=== Speaker Diarization Segments ===');
    response.data.segments?.forEach(seg => {
      console.log(`[${seg.start.toFixed(2)}s - ${seg.end.toFixed(2)}s] ${seg.speaker || 'Speaker'}: ${seg.text}`);
    });

    return response.data;
  } catch (error) {
    console.error('Transcription Error:', error.response?.data || error.message);
  }
}

transcribeAudioFile('./recording.mp3');

// Browser Real-Time WebSocket Streaming Example
const API_KEY = 'YOURVOIC_API_KEY';
const STREAM_URL = `wss://yourvoic.com/api/v1/transcription/stream?token=${API_KEY}`;

const socket = new WebSocket(STREAM_URL);

socket.onopen = () => {
  console.log('Connected to YourVoic Real-Time WebSocket Stream!');
  startMicrophoneStream();
};

socket.onmessage = (event) => {
  const data = JSON.parse(event.data);
  if (data.type === 'partial') {
    console.log('⚡ Partial Transcript:', data.text);
    document.getElementById('live-transcript').innerText = data.text;
  } else if (data.type === 'final') {
    console.log('✓ Final Transcript Segment:', data.text);
  }
};

async function startMicrophoneStream() {
  const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
  const mediaRecorder = new MediaRecorder(stream, { mimeType: 'audio/webm' });

  mediaRecorder.ondataavailable = (event) => {
    if (event.data.size > 0 && socket.readyState === WebSocket.OPEN) {
      socket.send(event.data); // Stream raw audio blob
    }
  };

  mediaRecorder.start(100); // 100ms chunk interval
}