# ElevenLabs Music — Endpoint-Skizze (TBD, v0.19.0)

> **Wichtig:** Diese Datei ist eine Spec-Skizze, nicht verifiziert.
> Der Music-Endpoint ist in v0.18.0 als Stub reserviert.
> Vollausbau verschoben auf v0.19.0 laut HARD-LOCK §8.1 (Architektur-Spec V0.17.11).

---

## Status

Endpoint-Existenz und Account-Tier-Verfügbarkeit sind vor v0.19.0 zu klären.
Kein Live-Aufruf in v0.18.0 möglich — `scripts/generate_music.py` wirft `NotImplementedError`.

## Endpoint-URL-Slot (TBD)

```
POST https://api.elevenlabs.io/v1/music  ← TBD, nicht verifiziert
```

## Input-Schema-Skizze (nicht verifiziert)

| Feld | Typ | Beschreibung |
|---|---|---|
| Prompt-String | string | Textbeschreibung des gewünschten Musikstücks |
| Dauer in Sekunden | integer | Gewünschte Länge (TBD: Min/Max-Limits) |
| Genre-Hints | string[] | Optionale Genre-Vorgaben (TBD: unterstützte Werte) |

## Output-Audio-Format-Plan (nicht verifiziert)

- Format: mp3 oder wav (TBD)
- Sample-Rate: TBD
- Kanäle: Mono oder Stereo (TBD)

## Stub-Verweis

`scripts/generate_music.py` enthält ausschließlich:

```python
raise NotImplementedError(
    "Music-Pfad: v0.19.0 — Endpoint-Verifikation und Account-Tier-Klärung ausstehend"
)
```

Kein Import von `_lib.api_keys`, keine Helper-Funktionen, kein `if __name__ == "__main__"`.

## Offene Punkte für v0.19.0

1. Endpoint-URL verifizieren (ElevenLabs API-Changelog prüfen).
2. Account-Tier-Anforderungen klären (Creator / Pro / Enterprise).
3. Input/Output-Schema gegen echte API-Doku abgleichen.
4. `references/music.md` von Stub auf vollständige Referenz aktualisieren.
5. `eval/elevenlabs-api.eval.json` Case `music-stub-existence` durch echte Music-Eval-Cases ersetzen.
