Quickstart

curl -X POST https://api.voxnexus.ai/v1/tts \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello, welcome to VoxNexus!",
    "model_id": "vn-tts-basic",
    "voice_id": "vn-xiaoxiao",
    "format": "wav",
    "sample_rate": 16000
  }' \
  --output audio.wav

curl -X POST "https://api.voxnexus.ai/v1/stt?model_id=vn-stt-basic&sample_rate=16000&language=en-US" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: audio/wav" \
  --data-binary @your-audio.wav

async function synthesizeSpeech(text, voiceId) {
  const response = await fetch('https://api.voxnexus.ai/v1/tts', {
    method: 'POST',
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      text: text,
      model_id: 'vn-tts-basic',
      voice_id: voiceId,
      format: 'wav',
      sample_rate: 16000
    })
  });
  
  if (!response.ok) {
    throw new Error(`HTTP ${response.status}`);
  }
  
  const audioBlob = await response.blob();
  const audioUrl = URL.createObjectURL(audioBlob);
  const audio = new Audio(audioUrl);
  audio.play();
}

// Usage
synthesizeSpeech('Hello, world!', 'vn-xiaoxiao');

import requests

def synthesize_speech(text, voice_id, api_key):
    url = 'https://api.voxnexus.ai/v1/tts'
    headers = {
        'X-Api-Key': api_key,
        'Content-Type': 'application/json'
    }
    data = {
        'text': text,
        'model_id': 'vn-tts-basic',
        'voice_id': voice_id,
        'format': 'wav',
        'sample_rate': 16000
    }
    
    response = requests.post(url, json=data, headers=headers)
    response.raise_for_status()
    
    with open('output.wav', 'wb') as f:
        f.write(response.content)
    
    return 'output.wav'

# Usage
synthesize_speech('Hello, world!', 'vn-xiaoxiao', 'YOUR_API_KEY')

// Connect with token as query parameter (recommended for browser)
const ws = new WebSocket('wss://api.voxnexus.ai/v1/tts/realtime?token=YOUR_API_KEY');

ws.onopen = () => {
  // Initialize
  ws.send(JSON.stringify({
    type: 'init',
    model_id: 'vn-tts-basic',
    voice_id: 'vn-xiaoxiao',
    format: 'wav',
    sample_rate: 16000
  }));
};

ws.onmessage = (event) => {
  const message = JSON.parse(event.data);
  
  if (message.type === 'ready') {
    // Send text to synthesize
    ws.send(JSON.stringify({
      type: 'text',
      text: 'Hello, world!',
      is_final: true
    }));
  } else if (message.type === 'audio') {
    // Handle audio data (base64 encoded)
    const audioData = atob(message.data);
    // Play audio...
  }
};