API Documentation

Request Body

{
  "text":   "Your text here",      // required, max 2000 chars (registered)
  "voice":  "id-ID-GadisNeural",  // optional, default: id-ID-GadisNeural
  "rate":   "+0%",                 // optional, range: -50% to +100%
  "pitch":  "+0Hz",                // optional, range: -50Hz to +50Hz
  "volume": "+0%",                 // optional, range: -50% to +50%
  "format": "mp3",                 // optional: mp3, wav, ogg, flac
  "bitrate": "128k",               // optional: 64k, 96k, 128k, 192k, 256k, 320k
  "webhook_url": "https://example.com/hook", // optional completion callback
  "webhook_secret": "your-signing-secret",     // optional HMAC signature
  "style":  "cheerful",            // optional, emotion/style (voice-specific)
  "style_degree": 1.0              // optional, style intensity (0.01-2.0)
}

cURL Example

curl -X POST https://eidosspeech.xyz/api/v1/tts \
  -H "X-API-Key: esk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello, this is a test of the text to speech API.",
    "voice": "en-US-JennyNeural",
    "format": "wav",
    "bitrate": "192k",
    "rate": "+10%",
    "pitch": "+5Hz"
  }' \
  --output audio.wav

Python Example

import requests

response = requests.post(
    "https://eidosspeech.xyz/api/v1/tts",
    headers={"X-API-Key": "esk_your_api_key"},
    json={
        "text": "Halo, selamat datang di eidosSpeech!",
        "voice": "id-ID-GadisNeural",
        "format": "mp3",
        "bitrate": "128k",
        "rate": "+0%"
    }
)

if response.status_code == 200:
    with open("output.mp3", "wb") as f:
        f.write(response.content)
    print(f"Remaining: {response.headers.get('X-RateLimit-Remaining-Day')}")
else:
    print(response.json())

JavaScript Example

const response = await fetch('https://eidosspeech.xyz/api/v1/tts', {
  method: 'POST',
  headers: {
    'X-API-Key': 'esk_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    text: 'Welcome to eidosSpeech API!',
    voice: 'en-US-AriaNeural',
    rate: '+0%',
    pitch: '+0Hz'
  })
});

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

Request Body

{
  "script": "[John]: Hello!\\n[Mary]: Hi there!",  // required, format: [Speaker]: Text
  "voice_map": {                                      // required, speaker → voice mapping
    "John": "en-US-GuyNeural",
    "Mary": "en-US-JennyNeural"
  },
  "pause_ms": 500,                                  // optional, pause between lines (0-2000ms, default: 500)
  "rate": "+0%",                                     // optional, speech rate (-50% to +100%)
  "pitch": "+0Hz",                                    // optional, pitch adjustment (-50Hz to +50Hz)
  "volume": "+0%"                                    // optional, volume level (-50% to +50%)
}

Script Format

Each line must follow the format: [SpeakerName]: Dialog text

[John]: Hello, how are you today?
[Mary]: I'm doing great, thanks for asking!
[John]: That's wonderful to hear.
[Mary]: How about you?

cURL Example

curl -X POST https://eidosspeech.xyz/api/v1/tts/script \
  -H "X-API-Key: esk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "script": "[Host]: Welcome to our podcast!\\n[Guest]: Thanks for having me!",
    "voice_map": {
      "Host": "en-US-GuyNeural",
      "Guest": "en-US-JennyNeural"
    },
    "pause_ms": 800
  }' \
  --output podcast.mp3

Python Example

import requests

script = """[Narrator]: Once upon a time...
[Character1]: Hello there!
[Character2]: Hi! How are you?"""

response = requests.post(
    "https://eidosspeech.xyz/api/v1/tts/script",
    headers={"X-API-Key": "esk_your_api_key"},
    json={
        "script": script,
        "voice_map": {
            "Narrator": "en-US-AriaNeural",
            "Character1": "en-US-GuyNeural",
            "Character2": "en-US-JennyNeural"
        },
        "pause_ms": 600
    }
)

if response.status_code == 200:
    with open("output.mp3", "wb") as f:
        f.write(response.content)
else:
    print(response.json())

JavaScript Example

const script = `[Host]: Welcome to the show!
[Guest]: Thank you for having me!
[Host]: Let's dive right in.`;

const response = await fetch('https://eidosspeech.xyz/api/v1/tts/script', {
  method: 'POST',
  headers: {
    'X-API-Key': 'esk_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    script: script,
    voice_map: {
      'Host': 'en-US-GuyNeural',
      'Guest': 'en-US-JennyNeural'
    },
    pause_ms: 700
  })
});

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

Request Body

{
  "text":  "Your text here",
  "voice": "id-ID-GadisNeural"  // optional
}

Request Body

{
  "ssml": "<speak>Hi<break time=\"500ms\"/> welcome to <sub alias=\"eye-doss speech\">eidosSpeech</sub>.</speak>",
  "voice": "en-US-JennyNeural"
}

Request Body

{
  "text": "A very long article… multiple paragraphs…",
  "voice": "en-US-JennyNeural",
  "rate": "+0%",
  "pitch": "+0Hz",
  "volume": "+0%"
}

Request Body

{
  "requests": [
    { "text": "Halo", "voice": "id-ID-GadisNeural", "format": "mp3" },
    { "text": "Hello", "voice": "en-US-JennyNeural", "format": "wav", "bitrate": "192k" }
  ]
}

Query Parameters