API Reference

curl -X POST "https://yourvoic.com/api/v1/tts/generate" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello, welcome to YourVoic!",
    "voice": "Peter",
    "model": "aura-prime",
    "language": "en-US",
    "speed": 1.0
  }'

HTTP/1.1 200 OK
Content-Type: audio/wav
Content-Disposition: attachment; filename=tts_1763016758696.wav
Content-Length: 48532
X-Request-ID: tts_1763016758696
X-Processing-Time-Ms: 2850

response = requests.post(...)
with open("output.wav", "wb") as f:
    f.write(response.content)

const fs = require('fs');
const response = await fetch(...);
const buffer = Buffer.from(await response.arrayBuffer());
fs.writeFileSync('output.wav', buffer);

const response = await fetch(...);
const blob = await response.blob();
const audioUrl = URL.createObjectURL(blob);
const audio = new Audio(audioUrl);
audio.play();

curl -X POST "https://yourvoic.com/api/v1/tts/stream" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello, this is streaming audio!",
    "voice": "Peter",
    "model": "aura-prime"
  }' \
  --output audio.pcm

# Convert PCM to WAV for playback
ffmpeg -f s16le -ar 24000 -ac 1 -i audio.pcm audio.wav

import requests

response = requests.post(
    "https://yourvoic.com/api/v1/tts/stream",
    headers={
        "X-API-Key": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "text": "Hello, streaming world!",
        "voice": "Peter",
        "model": "aura-prime"
    },
    stream=True
)

# Save raw PCM
with open("audio.pcm", "wb") as f:
    for chunk in response.iter_content(chunk_size=1024):
        f.write(chunk)

# Or use pydub to convert and play
from pydub import AudioSegment
audio = AudioSegment.from_raw(
    "audio.pcm", 
    sample_width=2, 
    frame_rate=24000, 
    channels=1
)
audio.export("audio.wav", format="wav")

async function streamAndPlay(text) {
  const response = await fetch("https://yourvoic.com/api/v1/tts/stream", {
    method: "POST",
    headers: {
      "X-API-Key": "YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      text: text,
      voice: "Peter",
      model: "aura-prime"
    })
  });

  // Create AudioContext for real-time playback
  const audioContext = new AudioContext({ sampleRate: 24000 });
  const reader = response.body.getReader();
  
  while (true) {
    const { done, value } = await reader.read();
    if (done) break;
    
    // Convert PCM bytes to audio buffer
    const int16Array = new Int16Array(value.buffer);
    const float32Array = new Float32Array(int16Array.length);
    for (let i = 0; i < int16Array.length; i++) {
      float32Array[i] = int16Array[i] / 32768;
    }
    
    // Play the chunk
    const audioBuffer = audioContext.createBuffer(1, float32Array.length, 24000);
    audioBuffer.getChannelData(0).set(float32Array);
    const source = audioContext.createBufferSource();
    source.buffer = audioBuffer;
    source.connect(audioContext.destination);
    source.start();
  }
}

const fs = require('fs');

async function streamTTS() {
  const response = await fetch("https://yourvoic.com/api/v1/tts/stream", {
    method: "POST",
    headers: {
      "X-API-Key": "YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      text: "Hello from Node.js streaming!",
      voice: "Peter",
      model: "rapid-max"  // Premium HD quality
    })
  });

  const fileStream = fs.createWriteStream("audio.pcm");
  const reader = response.body.getReader();
  
  while (true) {
    const { done, value } = await reader.read();
    if (done) break;
    fileStream.write(Buffer.from(value));
  }
  
  fileStream.end();
  console.log("Audio saved to audio.pcm");
}

curl "https://yourvoic.com/api/v1/voices?language=en-US" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "voices": [
    {
      "voice_id": "peter",
      "name": "Peter",
      "gender": "male",
      "language": "en-US",
      "preview_url": "https://yourvoic.com/voices/peter.mp3"
    },
    {
      "voice_id": "kylie",
      "name": "Kylie",
      "gender": "female",
      "language": "en-US",
      "preview_url": "https://yourvoic.com/voices/kylie.mp3"
    }
  ],
  "total": 2
}

curl "https://yourvoic.com/api/v1/languages" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://yourvoic.com/api/v1/languages?model=rapid-max" \
  -H "X-API-Key: YOUR_API_KEY"