schwiizerduetsch 0.1.1

Python-SDK für die schwiizerdütsch.com Züritüütsch-Text-to-Speech-API

schwiizerdütsch.com — Python SDK

Züritüütsch (Zürcher Schweizerdeutsch) Text-to-Speech mit eigener Stimme.

Installation

pip install schwiizerduetsch

Schnellstart

from schwiizerduetsch import Client

client = Client("sk_live_...")          # API-Key aus dem Dashboard (Pro-Plan)
audio = client.speak("Grüezi mitenand, schön sind Sie da.")
audio.save("hallo.mp3")

Optionen

client.speak(
    text,                 # Hochdeutsch oder Schweizerdeutsch
    voice="marco",        # Stimme (aktuell nur 'marco')
    format="mp3",         # mp3 (Free) · wav / ogg / flac (Pro)
    speed=1.0,            # Tempo 0.5–2.0
    normalize=True,       # Hochdeutsch/CH-Input → kanonische Züritüütsch-Schreibweise
)

Der Text wird serverseitig automatisch in die richtige Schweizerdeutsch-Schreibweise normalisiert (normalize=True) — du kannst also direkt Hochdeutsch schicken.

Fehlerbehandlung

from schwiizerduetsch import Client, TTSError

client = Client("sk_live_...")
try:
    client.speak("Test").save("out.mp3")
except TTSError as e:
    print(e.status, e.message)   # z. B. 401 Ungültiger API-Key, 429 Limit erreicht

Limits & Pläne

	Free	Pro
Zeichen	1'000 / Tag	500'000 / Monat
Formate	MP3	MP3, WAV, OGG, FLAC
API-Keys	–	✓

API-Keys werden im Dashboard unter API & Keys erstellt (Pro-Plan).