Metadata-Version: 2.4
Name: schwiizerduetsch
Version: 0.1.1
Summary: Python-SDK für die schwiizerdütsch.com Züritüütsch-Text-to-Speech-API
Author: schwiizerdütsch.com
License: MIT
Project-URL: Homepage, https://schwiizerdütsch.com
Project-URL: Documentation, https://schwiizerdütsch.com/docs
Keywords: tts,text-to-speech,swiss german,schwiizerdütsch,zürituutsch
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Requires-Python: >=3.7
Description-Content-Type: text/markdown

# schwiizerdütsch.com — Python SDK

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

## Installation

```bash
pip install schwiizerduetsch
```

## Schnellstart

```python
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

```python
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

```python
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).
