API-Dokumentation

POST /generate

Erstellt aus einem übergebenen Text eine Audiodatei (MP3).

Endpunkt
https://api.satzklang.audio/generate
Methode
POST
Antwort
Binärer Audio-Stream (audio/mpeg)

Header

Header Wert Beschreibung
Authorization Bearer <DEIN_API_KEY> Authentifizierungstoken
Content-Type application/json Datenformat des Requests

Request Body (JSON)

Feld Typ Pflicht Beschreibung
voice string Ja Name der Standardstimme (z. B. "haecker").
language string Ja Sprache der Synthese (z. B. "German").
text string Ja Der zu vertonende Text. Unterstützt Inline-Tags.

Inline-Steuerbefehle im Text

  • Pausen einfügen: [pause 1.5] (Dauer in Sekunden angeben)
  • Stimme wechseln: [voice:sprechername]Gesprochener Text[/voice] (wechselt abschnittsweise die Stimme)

Beispielaufruf (cURL)

curl -sS -X POST "https://api.satzklang.audio/generate" \
  -H "Authorization: Bearer <DEIN_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "language": "German",
    "voice": "haecker",
    "text": "Die Tarifverhandlungen im öffentlichen Dienst..."
  }' \
  --output ausgabe.mp3