API Documentation | SpeakSynth

Introduction

SpeakSynth is a developer-friendly Text-to-Speech API powered by AI. Convert your text to natural-sounding speech with a simple API call.

Key Features

No signups or complex authentication
Single endpoint for text-to-speech conversion
Supports WAV and OPUS output formats
Generous free tier (15 requests/day)

Authentication

SpeakSynth uses API key authentication. Include your key in all requests as a header:

HTTP Headers

X-API-Key: your_api_key_here

Don't have an API key? Generate one instantly.

Endpoints

GET /speaksynth/health

Health Check

Check if the API is operational.

Example Response

{
  "status": "ok",
  "message": "🔊 SpeakSynth API is alive!"
}

POST /speaksynth/api/v1/synthesize

Synthesize Speech

Convert text to speech audio. Requires API key authentication.

Headers

X-API-Key: your_api_key_here
Content-Type: application/json

Request Body

{
  "text": "Hello, this is a test message.",
  "format": 1,
  "voice": "sabrina"
}

Response

Returns the audio file in the requested format.

Rate Limits

To ensure fair usage, the following limits apply:

Daily limit: 15 requests per day
Voice options: 3 premium voices available
Text length: Maximum 1,000 characters per request

Rate limit errors return a 429 Too Many Requests status code.

Code Examples

# Synthesize Speech
curl -X POST https://apispeaksynth.publicvm.com/speaksynth/api/v1/synthesize \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{"text":"Hello world!","format":1}' \
  --output speech.wav

# Check Usage
curl -X GET https://api.speaksynth.com/speaksynth/api/v1/usage \
  -H "X-API-Key: your_api_key_here"

import requests

# Your API key from the SpeakSynth dashboard
api_key = "your_api_key_here"

# Synthesize Speech
headers = {"X-API-Key": api_key, "Content-Type": "application/json"}
data = {"text": "Hello world!", "format": 1}  # 1 = WAV, 2 = OPUS

response = requests.post(
    "https://apispeaksynth.publicvm.com/speaksynth/api/v1/synthesize", 
    headers=headers,
    json=data
)

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

// Your API key from the SpeakSynth dashboard
const apiKey = "your_api_key_here";

// Synthesize Speech
async function synthesizeSpeech(text, voice = "sabrina") {
  const response = await fetch("https://speaksynth.onrender.com/speaksynth/api/v1/synthesize", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-API-Key": apiKey
    },
    body: JSON.stringify({
      text: text,
      format: 1,  // 1 = WAV, 2 = OPUS
      voice: voice  // "sabrina", "paul", or "morgan"
    })
  });
  
  const audioBlob = await response.blob();
  const audioUrl = URL.createObjectURL(audioBlob);
  
  // Play audio
  const audio = new Audio(audioUrl);
  audio.play();
}

// Example usage with different voices
synthesizeSpeech("Hello world!", "sabrina");  // Default bright voice
synthesizeSpeech("Welcome to the future.", "paul");    // Jarvis-style
synthesizeSpeech("In a world of infinite possibilities...", "morgan"); // Deep authoritative

Ready to get started?

Generate your API key and start converting text to speech in minutes.

Generate Free API Key