API Reference

SAYIT-API-KEY: sk_live_your_api_key_here

curl -X POST https://api.sayitapi.com/v1/tts \
  -H "SAYIT-API-KEY: sk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello! This is <emphasis>SayIt API</emphasis>.",
    "voice_id": "eve",
    "language": "en",
    "output_format": "mp3",
    "speech_tags": true
  }'

import requests

response = requests.post(
    "https://api.sayitapi.com/v1/tts",
    headers={
        "SAYIT-API-KEY": "sk_live_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "text": "Hello! This is SayIt API.",
        "voice_id": "eve",
        "language": "en",
        "output_format": "mp3",
        "speech_tags": False,
    },
    timeout=15,
)
response.raise_for_status()
data = response.json()

print(data["audio_url"])           # Stream or download this URL
print(data["duration_seconds"])    # e.g. 2.8
print(data["characters_used"])     # billed characters

interface TtsResponse {
  id: string;
  status: string;
  audio_url: string;
  duration_seconds: number;
  characters_used: number;
  voice_id: string;
  created_at: string;
}

async function synthesize(text: string): Promise<TtsResponse> {
  const res = await fetch("https://api.sayitapi.com/v1/tts", {
    method: "POST",
    headers: {
      "SAYIT-API-KEY": process.env.SAYIT_API_KEY!,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      text,
      voice_id: "eve",
      language: "en",
      output_format: "mp3",
    }),
  });

  if (!res.ok) {
    const error = await res.json();
    throw new Error(`SayIt error: ${error.error.code} - ${error.error.message}`);
  }

  return res.json();
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "You have exceeded 200 requests per minute. Retry after 18 seconds.",
    "retry_after": 18
  }
}