LangVoice API Documentation

curl -X POST "https://api.langvoice.com/api/v1/tts/generate" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world", "voice": "heart", "language": "american_english"}'

import requests

API_KEY = "your_api_key_here"
BASE_URL = "https://api.langvoice.com/api/v1"

def generate_speech(text: str, voice: str = "heart", language: str = "american_english", speed: float = 1.0):
    """Generate speech from text using the LangVoice API."""
    
    response = requests.post(
        f"{BASE_URL}/tts/generate",
        headers={
            "X-API-Key": API_KEY,
            "Content-Type": "application/json"
        },
        json={
            "text": text,
            "voice": voice,
            "language": language,
            "speed": speed
        }
    )
    
    if response.status_code == 200:
        # Save the audio file
        with open("output.mp3", "wb") as f:
            f.write(response.content)
        
        # Get generation info from headers
        duration = response.headers.get("X-Audio-Duration")
        gen_time = response.headers.get("X-Generation-Time")
        print(f"Audio duration: {duration}s, Generated in: {gen_time}s")
        return True
    else:
        print(f"Error: {response.json()}")
        return False

# Usage
generate_speech(
    text="Hello, welcome to LangVoice! This is a test of the text-to-speech API.",
    voice="heart",
    language="american_english",
    speed=1.0
)