VOCABLE Documentation

import requests

response = requests.post(
    "https://vocable.draftlabs.org/api/tts",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "text": "Welcome to our platform. How can I help you today?",
        "model": "nvidia-magpie",
        "voice": "Magpie-Multilingual.EN-US.Aria"
    }
)

# Save to file
with open("welcome.wav", "wb") as f:
    f.write(response.content)

# Or play directly (requires playsound package)
# from playsound import playsound
# playsound("welcome.wav")

const response = await fetch("https://vocable.draftlabs.org/api/tts", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    text: "Your order has been confirmed. It will arrive by Friday.",
    model: "nvidia-magpie",
    voice: "Magpie-Multilingual.EN-US.Jason",
  }),
});

const audioBuffer = Buffer.from(await response.arrayBuffer());
require("fs").writeFileSync("confirmation.wav", audioBuffer);

from langchain.tools import tool
import requests

@tool
def speak(text: str) -> str:
    """Convert text to speech using VOCABLE TTS API."""
    response = requests.post(
        "https://vocable.draftlabs.org/api/tts",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        json={"text": text, "model": "nvidia-magpie", "voice": "Magpie-Multilingual.EN-US.Aria"}
    )
    with open("/tmp/agent_speech.wav", "wb") as f:
        f.write(response.content)
    return f"Audio saved ({len(response.content)} bytes)"

# Use in your agent
# agent = initialize_agent([speak], llm, agent="zero-shot-react-description")
# agent.run("Say hello to the user")

import requests

API = "https://vocable.draftlabs.org/api/tts"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

# Generate the same message in 3 languages
messages = [
    ("Hello, welcome!", "Magpie-Multilingual.EN-US.Aria", "en-US"),
    ("Hallo, willkommen!", "Magpie-Multilingual.DE-DE.Aria", "de-DE"),
    ("Hola, bienvenido!", "Magpie-Multilingual.ES-US.Aria", "es-US"),
]

for text, voice, lang in messages:
    response = requests.post(API, headers=HEADERS, json={
        "text": text,
        "model": "nvidia-magpie",
        "voice": voice,
        "language": lang,
    })
    with open(f"welcome_{lang}.wav", "wb") as f:
        f.write(response.content)
    print(f"{lang}: {len(response.content)} bytes")