Häufig gestellte Fragen
Wie erhalte ich einen API-Schlüssel?
Registrieren Sie sich auf /get-api-key/ mit Google oder E-Mail. Nach dem Login sehen Sie Ihren Schlüssel, Ihr Guthaben und eine curl-Vorlage. Pro Konto ist nur ein aktiver Schlüssel möglich. Ein neuer Schlüssel kann jederzeit ausgestellt werden, wodurch der alte sofort ungültig wird.
Welche Endpunkte gibt es?
Nutzen Sie POST /v1/audio/speech zur Generierung. GET /v1/voices listet Stimmen, Sprachen und Formate auf, GET /v1/models die Modelle. Die Struktur entspricht OpenAI, sodass SDKs mit angepasster base_url direkt funktionieren. Authentifizieren Sie sich mit Bearer-Tokens. Rate Limits liegen bei 60 Requests pro Minute. So integrieren Sie die TTS-API nahtlos in Ihre LMS- oder Startup-Workflows.
Wie funktioniert die Authentifizierung?
Übergeben Sie den Schlüssel im Header als Authorization: Bearer tts-.... Pro Konto gibt es genau einen aktiven Schlüssel. Bei Ausgabe eines neuen Schlüssels wird der alte sofort deaktiviert. Dies gewährleistet einfache und sichere Authentifizierung für Ihre API-Anfragen.
Welche Formate werden unterstützt?
Wählen Sie mp3, wav, opus, flac oder pcm als response_format. Die Angabe erfolgt direkt im JSON-Body Ihrer POST-Anfrage an den speech-Endpunkt. So passen Sie die Ausgabe exakt an Ihre technischen Anforderungen an. Die Wahl des Formats bleibt Ihnen frei, während wir die Synthese für Sie übernehmen.
Wie viele Anfragen pro Minute sind erlaubt?
Pro API-Schlüssel sind 60 Anfragen pro Minute erlaubt. Vor Ihrer ersten Top-up-Zahlung liegt das Limit bei 10 Anfragen pro Minute. Da die Verarbeitung sequenziell erfolgt, kann es unter hoher Last zu Wartezeiten in der Queue kommen, was die Generierungsdauer leicht erhöht. Dies gewährleistet eine faire Ressourcenverteilung für alle Nutzer unseres TTS-API.
Was passiert bei einem Fehler?
Bei einer fehlgeschlagenen Synthese erhalten Sie die Gebühr vollständig erstattet. So schützen wir Ihr Guthaben vor unnötigen Kosten, falls technische Probleme auftreten. Erfolgreiche Anfragen werden wie gewohnt berechnet. Wir empfehlen, bei Fehlern die Antwortcodes und Fehlermeldungen der API zu prüfen, um die Ursache schnell zu identifizieren und den Prozess nahtlos fortzusetzen.
Kann ich die Geschwindigkeit ändern?
Ja, Sie passen die Geschwindigkeit mit dem Parameter speed im Bereich von 0,25 bis 4,0 an. Dies ermöglicht eine schnellere oder langsamere Sprachausgabe für Ihre Inhalte. Passen Sie die Geschwindigkeit flexibel an den Kontext und Ihre Zielgruppe an, ohne dass zusätzliche Kosten entstehen.
Wie lange sind die Audiodateien gültig?
Die Audiodaten werden nicht gespeichert, sondern direkt in der Antwort bereitgestellt. Es gibt keine spezifische Gültigkeitsdauer für die Dateien selbst; Sie müssen sie bei Bedarf selbst speichern. Das Guthaben verfällt nicht, aber die Testgutschrift ist 7 Tage gültig.
Gibt es eine Sandbox-Umgebung?
Nein, wir bieten keine separate Sandbox-Umgebung. Die API ist direkt unter api.playgtr35.com erreichbar und identisch zur Produktionsumgebung. Testen Sie einfach mit Ihrem API-Schlüssel. Das Testguthaben von 0,50 $ (ca. 50.000 Zeichen) ermöglicht erste Tests direkt in der Live-Umgebung, bevor Sie Guthaben über USDT aufladen.
Wie werde ich bei Fehlern informiert?
Fehlermeldungen erhalten Sie direkt im JSON-Response der API. Wir bieten keine Telefonnummer und keinen Live-Chat; der Support erfolgt ausschließlich per E-Mail. Bei technischen Problemen nutzen Sie bitte die Kontaktseite. Prüfen Sie vor einer Anfrage stets die Fehlerdetails in der API-Antwort, um das Problem schnell zu identifizieren.
Kann ich mehrere API-Schlüssel haben?
Pro Konto ist jeweils nur ein aktiver API-Schlüssel gültig. Sie können jedoch jederzeit einen neuen Schlüssel ausstellen. Dabei wird der alte Schlüssel sofort ungültig. Dieser Mechanismus vereinfacht das Schlüsselmanagement erheblich, da Sie den Zugang bei Bedarf schnell anpassen können, ohne Ihr Konto neu erstellen zu müssen.
Wie lange wird ein Schlüssel gespeichert?
Ihr API-Schlüssel bleibt unbegrenzt aktiv, solange Sie ihn nicht durch einen neuen ersetzen. Ein neues Schlüssel-Setup beendet den alten sofort. Die Schlüssel selbst werden nicht automatisch gelöscht. Für Abrechnungszwecke speichern wir die Metadaten Ihrer Anfragen, der generierte Audioinhalt jedoch nicht. Sie haben die volle Kontrolle über Ihre Schlüssel und deren Status.
Was ist der Unterschied zwischen tts-1 und tts-1-hd?
Beide Modelle nutzen dieselbe Engine und kosten identisch 10 $ pro 1 Mio. Zeichen. Der Unterschied liegt im Namen. Da Preis und Leistung gleich sind, können Sie jedes Modell wählen. Beide verarbeiten Texte mit gleicher Geschwindigkeit und Qualität für Ihre E-Learning-Inhalte.
Wie ändere ich die Stimme in der API?
Legen Sie den Parameter voice im JSON-Body fest. Verfügbare Stimmen sind aria, nova, luna, sage, felix, milo, atlas und orion. Jede Stimme beherrscht alle 23 unterstützten Sprachen. Für Texte in lateinischer Schrift, die nicht Englisch sind, setzen Sie das optionale Feld language explizit, damit die Sprache korrekt erkannt wird. Passen Sie die Stimme einfach an den gewünschten Klang an.
Erste Anfrage
curl
curl https://api.playgtr35.com/v1/audio/speech \
-H "Authorization: Bearer $TTS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"tts-1","voice":"aria","input":"Hello from the API.","response_format":"mp3"}' \
--output hello.mp3Python (openai)
from openai import OpenAI
client = OpenAI(base_url="https://api.playgtr35.com/v1", api_key="tts-...")
with client.audio.speech.with_streaming_response.create(
model="tts-1", voice="nova", input="Hello from Python.", response_format="mp3"
) as response:
response.stream_to_file("hello.mp3")Node.js (openai)
import OpenAI from "openai";
import fs from "node:fs";
const client = new OpenAI({ baseURL: "https://api.playgtr35.com/v1", apiKey: process.env.TTS_API_KEY });
const res = await client.audio.speech.create({ model: "tts-1", voice: "milo", input: "Hello from Node.js." });
fs.writeFileSync("hello.mp3", Buffer.from(await res.arrayBuffer()));| voice | |
|---|---|
aria | weiblich |
nova | weiblich |
luna | weiblich |
sage | weiblich |
felix | männlich |
milo | männlich |
atlas | männlich |
orion | männlich |
| language | |
|---|---|
ar | العربية |
zh | 中文 |
da | Dansk |
nl | Nederlands |
en | English |
fi | Suomi |
fr | Français |
de | Deutsch |
el | Ελληνικά |
he | עברית |
hi | हिन्दी |
it | Italiano |
ja | 日本語 |
ko | 한국어 |
ms | Bahasa Melayu |
no | Norsk |
pl | Polski |
pt | Português |
ru | Русский |
es | Español |
sw | Kiswahili |
sv | Svenska |
tr | Türkçe |
API-Schlüssel erhalten
Für die Nutzung der Stimmbild-API benötigen Sie einen API-Schlüssel. Die Registrierung erfolgt direkt auf unserer /get-api-key/ Seite. Sie können sich mit Ihrem Google-Konto anmelden oder ein Konto mit E-Mail und Passwort erstellen.
Nach der Anmeldung erhalten Sie sofort Zugriff auf Ihre persönliche API-Verwaltungsseite. Dort wird Ihr aktiver Schlüssel angezeigt, damit Sie direkt mit der Integration beginnen können.
Registrierung
Der Einstieg ist einfach: Besuchen Sie die Seite /get-api-key/. Sie können sich entweder mit Google anmelden oder ein Konto mit E-Mail und Passwort erstellen. Die Registrierung ist der erste Schritt zur barrierefreien Skalierung Ihrer Inhalte.
Schlüssel generieren
Nach dem Login wird Ihnen Ihr individueller API-Schlüssel angezeigt. Dieser Schlüssel autorisiert Ihre Anfragen an die Endpunkte. Er beginnt mit dem Präfix tts-.
Sie können jederzeit einen neuen Schlüssel generieren. Sobald ein neuer Schlüssel erstellt wird, wird der vorherige Schlüssel sofort ungültig. Dies gewährleistet eine saubere Verwaltung Ihrer Zugriffsrechte.
- Schlüssel beginnen mit
tts- - Neuer Schlüssel macht alten sofort ungültig
- Jedes Konto hat nur einen aktiven Schlüssel
Schlüssel verwalten
Alle relevanten Daten zu Ihrem Schlüssel finden Sie auf der Dashboard-Seite. Dort sehen Sie Ihren aktuellen Kontostand, das verbleibende Guthaben und die bereits verbrauchten Zeichen.
Das Dashboard zeigt auch ein fertiges cURL-Beispiel an, das Sie direkt kopieren und anpassen können. So starten Sie schnell mit ersten Tests Ihrer Text-zu-Sprache-Integration.
Erste Anfrage mit cURL
Dies ist der einzige Endpunkt für die Audiogenerierung. Mit einer POST-Anfrage an https://api.playgtr35.com/v1/audio/speech wandeln Sie Text direkt in Audio um. Die Struktur entspricht dem OpenAI-Standard, sodass bestehende Tools oft nahtlos funktionieren.
Senden Sie Ihren Text im JSON-Body. Wichtig: Die Zeichenlänge pro Anfrage beträgt maximal 4096 Zeichen. Für längere Texte müssen Sie diese zuvor in kleinere Abschnitte aufteilen und die Audiodateien später zusammenführen.
Endpoint
Nutzen Sie POST https://api.playgtr35.com/v1/audio/speech. Die Authentifizierung erfolgt über den Header Authorization: Bearer <IHR_API_SCHLÜSSEL>.
JSON Body
Das Request-JSON enthält model ("tts-1" oder "tts-1-hd"), input (max. 4096 Zeichen), voice (z. B. "aria"), response_format und optional speed (0.25–4.0).
Die unterstützten Formate sind MP3, WAV, OPUS, FLAC und PCM. Wählen Sie das Format, das am besten zu Ihrem LMS oder Ihrer Streaming-Architektur passt.
- model: "tts-1" oder "tts-1-hd"
- input: Ihr Text (max. 4096 Zeichen)
- voice: z. B. "nova", "atlas"
- response_format: "mp3", "wav", "opus", "flac" oder "pcm"
- speed: 0.25 bis 4.0
Response
Bei Erfolg erhalten Sie die Audio-Daten direkt im gewählten Format. Der Server speichert die Datei nicht, sie wird nur im Antwortstrom zurückgegeben.
Bei Fehlern (z. B. ungültiger Text oder Rate Limit) erhalten Sie einen HTTP-Fehlercode und eine Fehlermeldung im JSON-Format.

Integration mit OpenAI SDK
Die API folgt dem Request-Shape des OpenAI Speech-Endpunkts. Entwickler können das offizielle OpenAI SDK nutzen, indem sie die base_url auf https://api.playgtr35.com/v1 ändern und den Stimmbild-API-Schlüssel verwenden. Dies ermöglicht eine nahtlose Integration in bestehende Python- oder Node.js-Anwendungen ohne neue Bibliotheken.
Base URL ändern
Setzen Sie die Basis-URL Ihrer OpenAI-Client-Instanz auf https://api.playgtr35.com/v1. Dies leitet alle Anfragen an unsere Infrastruktur um, während die restliche API-Struktur identisch bleibt.
Code Beispiel
Initialisieren Sie den Client mit Ihrem API-Schlüssel und rufen Sie audio.speech auf. Der folgende Python-Code generiert Audio im MP3-Format mit der Stimme 'nova' und einer Geschwindigkeit von 1.0.
- from openai import OpenAI
- client = OpenAI(base_url='https://api.playgtr35.com/v1', api_key='tts-...')
- audio = client.audio.speech.create(
- model='tts-1',
- voice='nova',
- input='Willkommen bei Stimmbild.'
- )
Kompatibilität
Die API ist vollständig kompatibel mit dem offiziellen OpenAI SDK. Sie können dieselben Parameter wie model, voice, input und response_format verwenden.
Unterstützte Formate
Wir bieten fünf Audioformate an, damit Sie die Ausgabe optimal in Ihren LMS-Workflow integrieren können. Die Wahl hängt von Ihrem Anwendungsfall ab: MP3 für die Web-Wiedergabe, WAV für unverarbeitete Daten oder OPUS/FLAC für effiziente Speicherung.
MP3
MP3 ist das Standardformat für die meisten Web-Audio-Player. Es bietet ein gutes Verhältnis zwischen Dateigröße und Qualität, was die Ladezeiten in Ihren Online-Kursen verkürzt.
WAV
WAV eignet sich, wenn Sie eine einfache Weiterverarbeitung oder unverlustbehaftete Speicherung benötigen. Die Dateien sind größer, aber ohne Komprimierung.
Wählen Sie WAV, wenn eine einfache Weiterverarbeitung Ihrer Audio-Dateien im Editor erforderlich ist.
OPUS, FLAC, PCM
OPUS ist effizient für kleinere Dateigrößen bei guter Qualität und ideal für mobile Nutzung. FLAC bietet verlustfreie Kompression, während PCM rohe Audio-Daten ohne Kompression bereitstellt.
Fehlerbehandlung
Fehlerbehandlung ist bei der API-Nutzung entscheidend, um Kosten und Workflows im Griff zu behalten. Wir stellen sicher, dass Sie bei Synthesefehlern nicht für verlorene Arbeit bezahlen müssen. Jeder fehlgeschlagene Request wird vollständig erstattet, auch wenn er bereits abgerechnet wurde.
Durch klare Statuscodes und transparente Fehlermeldungen erkennen Sie Probleme sofort. Dies ermöglicht eine robuste Integration in Ihre LMS- oder E-Learning-Plattformen, ohne dass manuell nachgebucht werden muss.
HTTP Status Codes
Ein 400er Fehler bedeutet meist ein Problem mit Ihrer Anfrage, zum Beispiel ungültige Parameter. Ein 401er Fehler tritt auf, wenn der API-Schlüssel fehlt oder abgelaufen ist. Ein 500er Fehler deutet auf Serverseiten-Probleme hin. Bei einem Fehlschlag wird die Menge automatisch zurückerstattet.
- 200: Erfolgreiche Verarbeitung
- 400: Ungültige Anfrage
- 401: Ungültiger API-Schlüssel
- 429: Rate Limit überschritten
- 500: Interne Serverfehler
Häufige Fehler
Der häufigste Fehler ist das Überschreiten des Rate Limits von 60 Requests pro Minute. Hier erhalten Sie einen 429er Fehler. Ein weiterer häufiger Grund sind zu lange Eingabetexte über 4096 Zeichen. Stellen Sie sicher, dass Ihre Textblöcke diese Grenze einhalten, bevor Sie sie senden.
Wenn ein 500er Fehler auftritt, liegt es an vorübergehenden Serverproblemen. Die Charge wird zurückgegeben, und Sie können die Anfrage später erneut versuchen.
Debugging
Nutzen Sie die Antwort-Header, um den Status Ihrer Anfrage zu überprüfen. Prüfen Sie zuerst Ihre API-Schlüssel auf Richtigkeit. Stellen Sie sicher, dass Ihr Text die Zeichengrenze nicht überschreitet. Bei anhaltenden 500er Fehlern versuchen Sie es nach kurzer Wartezeit erneut.
- Prüfen Sie die Header auf Error-Details
- Validieren Sie die Textlänge vor dem Senden
- Erneut versuchen bei temporären Serverfehlern

Rate Limits verstehen
Die API begrenzt die Anfragen auf 60 Requests pro Minute pro Schlüssel. Dieses Limit gilt unabhängig vom gewählten Modell (tts-1 oder tts-1-hd) und stellt sicher, dass das System auch bei hoher Auslastung stabil bleibt. Für die meisten E-Learning-Anwendungen und batch-Verarbeitungen ist dieses Limit mehr als ausreichend, um Inhalte skalierbar zu generieren.
60 Requests/Minute
Jeder API-Schlüssel darf maximal 60 Anfragen in einer Minute senden. Dies ermöglicht eine gleichmäßige Verteilung der Rechenlast und verhindert Engpässe bei der Audiogenerierung.
Vor dem Top-up
Neue Konten ohne Guthaben starten mit einem reduzierten Limit von nur 10 Requests pro Minute. Dies dient dem Schutz vor Missbrauch, bis das erste Top-up bestätigt wurde.
Warteschlange
Bei hoher Auslastung oder Überschreitung des Limits werden Anfragen in eine Warteschlange gestellt. Sie werden nacheinander abgearbeitet, was die Generierungsdauer verlängern kann, aber die Datenintegrität gewährleistet.
Modelle und Stimmen
Unsere API nutzt zwei Modelle, die technisch identisch sind: tts-1 und tts-1-hd. Beide nutzen dieselbe Engine, liefern dieselbe Qualität und kosten gleich viel. Der Name ist lediglich ein Alias; Sie können jedes davon frei verwenden, ohne dass sich Preis oder Leistung ändern.
Die Stimme wählen Sie über das Feld voice. Sie können zwischen acht fest definierten Presets wählen, die auf lizenzierten Aufnahmen basieren. Jede Stimme spricht alle 23 unterstützten Sprachen flüssig. Wenn Sie die Sprache nicht explizit angeben, wird sie automatisch am Skript erkannt.
tts-1
tts-1 ist das Standardmodell für die Text-zu-Sprache-Umwandlung. Es erfüllt alle Anforderungen für E-Learning und digitale Bildung, da es klare und verständliche Audioausgaben liefert.
tts-1-hd
Das "High Definition"-Modell verwendet dieselbe Engine und denselben Preis wie tts-1. Es gibt keinen technischen Vorteil oder eine höhere Qualität. Es dient lediglich als alternative Bezeichnung in der API.
Stimmenauswahl
Wählen Sie aus vier weiblichen und vier männlichen Stimmen. Jede Stimme kann alle 23 unterstützten Sprachen sprechen.
- Aria: Warme, klare Erzählerin
- Nova: Hell und energisch
- Luna: Weich, für Geschichten
- Felix: Energetisch, perfekt für Promo
- Atlas: Neutral, ideal für Nachrichten
- Orion: Tief, dokumentarisch

Beispiel-Code für Python
Die offizielle OpenAI-SDK-Bibliothek für Python ist die empfohlene Methode, da sie die Authentifizierung über den Bearer-Token und die Handhabung der Audio-Antwort erheblich vereinfacht. Da die API das gleiche JSON-Format wie die OpenAI-Sprachausgabe verwendet, können Sie bestehende Integrationsmuster direkt übernehmen, ohne eine eigene Client-Library zu schreiben. Dies spart Zeit bei der Initialisierung der HTTP-Verbindung und der Fehlerbehandlung.
Das folgende Beispiel zeigt, wie Sie einen Text an den Endpoint senden und die resultierende Audiodatei lokal speichern. Die Bibliothek lädt die gesamte Datei in einer einzigen Antwort herunter, da die API keinen Streaming-Endpunkt unterstützt. Stellen Sie sicher, dass Ihr API-Schlüssel im Umgebungsvariable gespeichert ist, um die Sicherheit zu gewährleisten.
Bibliotheken
Installieren Sie die offizielle OpenAI-Client-Bibliothek für Python. Diese Bibliothek ist nicht unsere eigene, sondern die Standardimplementierung, die mit unserem Endpoint kompatibel ist. Sie erfordert Python 3.8 oder höher.
- pip install openai
Code Snippet
Dieses Python-Skript stellt eine POST-Anfrage an unseren Endpoint, gibt die Stimme 'nova' vor und speichert das Ergebnis als MP3. Passen Sie den base_url an die Domain des Stores an.
Ausführung
Nach dem Ausführen des Skripts wird die Datei 'speech.mp3' im aktuellen Verzeichnis erstellt. Der Vorgang dauert je nach Textlänge einige Sekunden bis Minuten, da Anfragen sequenziell verarbeitet werden. Bei 4096 Zeichen ist die Ausgabe in der Regel etwa in Echtzeit hörbar.
Hören Sie sich die 8 Stimmen an
Jede der folgenden Samples wurde von dieser API aus demselben Satz generiert. Wir entwickeln skalierbare Lernplattformen, damit Startups Wissen effizient an ihr Team weitergeben können.
23 Sprachen
Jede Stimme kann jede dieser Sprachen sprechen.
