API-Überblick

Mit der VocalLab API kannst du Sprache erzeugen, Stimmen auflisten und dein Guthaben programmatisch abfragen — aus deinen eigenen Apps, Skripten oder Automatisierungstools.

Sieh dir die komplette Anleitung an · auf Englisch

In jedem Tarif verfügbar, auch im kostenlosen. Jeder Aufruf verbraucht die Punkte deines Kontos (1 Punkt pro 15 Zeichen). Erstelle einen Schlüssel in Studio unter API & MCP in der Seitenleiste (oder auf der Seite Entwickler auf vocallab.ai). (AppSumo-Lifetime-Lizenzen: voller Zugriff ab Tier 3; Tier 1 und Tier 2 haben eingeschränkten Zugriff, mit niedrigerer Anfragerate und kürzeren Anfragen.)

Basis-URL

https://api.vocallab.ai

Authentifizierung

Sende deinen API-Schlüssel bei jeder Anfrage als Bearer-Token:

Authorization: Bearer vl_live_...

Schlüssel werden in Studio unter API & MCP (oder auf der Seite Entwickler) erstellt und widerrufen. Behandle einen Schlüssel wie ein Passwort — er wird nur einmal angezeigt, und jeder, der ihn besitzt, kann deine Credits ausgeben. Siehe API-Schlüssel.

Was du tun kannst

• Sprache erzeugen — POST /api/v1/tts (optional mit einem model)
• Stimmen auflisten — GET /api/v1/voices (Katalog + deine geklonten & designten Stimmen)
• Modelle auflisten — GET /api/v1/models (VocalLab Studio / Studio Flash / Pro / Lite)
• Status prüfen / die gehostete URL abrufen — GET /api/v1/tts/:id
• SRT-Untertitel herunterladen — GET /api/v1/tts/:id/captions (Untertitelzeilen oder Wort für Wort)
• Eine Stimme gestalten — POST /api/v1/voices/designs/previews, dann POST /api/v1/voices/designs zum Behalten
• Eine Stimme klonen — POST /api/v1/voices/clones (eine kurze Aufnahme, als base64 gesendet)
• Dein Guthaben prüfen — GET /api/v1/ping oder GET /api/v1/me

Ein Modell wählen

Übergib "model" an POST /api/v1/tts, um die Engine zu wählen (Standard v-studio):

• v-studio — VocalLab Studio: neuestes, steuerbar (befolgt Ausdrucksanweisungen), 200+ Sprachen. Der Standard.
• v-flash — VocalLab Studio Flash: dieselben 200+ Sprachen, etwa 5× schneller, berechnet ¾ der Punkte. Nicht steuerbar.
• v-pro — VocalLab Pro: höchste Wiedergabetreue, 15 Sprachen.
• v-lite — VocalLab Lite: schnell und sparsam — berechnet die Hälfte der Punkte.

Dein API-Schlüssel kann alle vier verwenden. Details findest du unter Sprachmodelle.

Vollständige Details findest du in der API-Referenz.

Abrechnung

API-Generierungen verbrauchen dieselben Credits wie die Web-App — 1 Credit = 1 Sekunde Audio. Die API rechnet mit 15 Zeichen pro Sekunde ab (etwas mehr als die 17 der Web-App). Du kannst niemals mehr als dein Guthaben ausgeben; Anfragen ohne ausreichende Credits geben 402 zurück.

In KI-Tools verwenden

Bevorzugst du Claude, Cursor oder einen anderen KI-Assistenten? Der MCP-Server stellt dieselben Funktionen als native Tools bereit — bei der gehosteten Option ist nichts zu installieren.