Häufig gestellte Fragen
Was ist die Base URL?
Die Base URL für die API ist https://api.77ff.info/v1. Dies ist die Basisadresse, die Sie für alle HTTP-Anfragen verwenden. Die Endpunkte wie /v1/audio/speech sind relativ zu dieser URL zu verstehen. Die Struktur orientiert sich an der OpenAI-API, wodurch bestehende Clients einfach angepasst werden können.
Wie erhalte ich einen API-Schlüssel?
Sie erhalten Ihren API-Schlüssel auf der Seite /get-api-key/. Dort registrieren Sie sich entweder mit Google oder mit E-Mail und Passwort. Nach der Anmeldung wird Ihnen der aktive Schlüssel angezeigt. Jeder Account besitzt genau einen aktiven Schlüssel, den Sie bei Bedarf jederzeit neu ausstellen können.
Welche Parameter sind erforderlich?
Erforderlich sind die Parameter model, input und voice. Das Feld model akzeptiert „tts-1“ oder „tts-1-hd“. input enthält den Text bis maximal 4096 Zeichen. voice muss eine der 8 verfügbaren Stimmen sein. Optional können response_format, speed und language angegeben werden, um Ausgabe und Geschwindigkeit anzupassen.
Was ist das Format der Antwort?
Die Antwort enthält die Audiodaten im angeforderten Format. Unterstützt werden mp3, wav, opus, flac und pcm als response_format. Die Datei wird direkt im Antwortkörper zurückgegeben. Bei Fehlern erhalten Sie eine Fehlermeldung. Die generierte Datei trägt ein unsichtbares Wasserzeichen, das sie als synthetische Sprache kennzeichnet.
Wie funktioniert die Authentifizierung?
Die Authentifizierung erfolgt über einen Bearer-Token im Header. Sie senden den Header „Authorization: Bearer tts-...“ mit Ihrem persönlichen API-Schlüssel. Dieser Schlüssel wird nach der Registrierung auf der Seite /get-api-key/ generiert. Jeder Account hat genau einen aktiven Schlüssel, der bei der Ausgabe eines neuen ungültig wird.
Was passiert bei einem Rate Limit?
Sie haben ein Limit von 60 Anfragen pro Minute pro Schlüssel. Vor der ersten Aufladung sind es nur 10 Anfragen pro Minute. Wenn das Limit erreicht ist, erhalten Sie einen HTTP-Fehler 429. Die Verarbeitung erfolgt sequenziell, sodass Anfragen unter Last verzögert werden können, bis sie bearbeitet werden.
Welche Fehlercodes gibt es?
Die Dokumentation listet spezifische HTTP-Fehlercodes detailliert auf. Im Allgemeinen signalisieren 4xx-Fehler Probleme mit der Anfrage, wie ungültige Parameter. 5xx-Fehler deuten auf Serverprobleme hin. Bei gescheiterter Synthese wird der Betrag vollständig erstattet. Für detaillierte Informationen zu spezifischen Fehlercodes konsultieren Sie bitte den Abschnitt zu Fehlerbehandlungen in der Dokumentation.
Kann ich das SDK von OpenAI nutzen?
Ja, Sie können die offiziellen OpenAI-SDKs nutzen. Dazu ändern Sie die base_url auf https://api.77ff.info/v1 und verwenden Ihren API-Schlüssel. Die Anfragestruktur entspricht der OpenAI-Speech-Endpunkt-Spezifikation. Dies ermöglicht eine einfache Integration in bestehende Anwendungen, die bereits mit OpenAI-Client-Bibliotheken arbeiten, ohne große Anpassungen.
Wie lange dauert die Generierung?
Die Generierung dauert bei langen Texten etwa Echtzeit, also ca. 25 Zeichen Text pro Sekunde Audiodauer. Kurze Sätze benötigen einige Sekunden. Anfragen werden nacheinander verarbeitet, sodass es bei hoher Last zu Wartezeiten in der Warteschlange kommen kann. Die Geschwindigkeit kann durch den Parameter speed zwischen 0,25 und 4,0 angepasst werden.
Welche Dateiformate gibt es?
Sie können die Ausgabe in den Formaten mp3, wav, opus, flac und pcm anfordern. Dies wird über das Feld response_format im JSON-Body festgelegt. Die Wahl des Formats hängt von Ihren Speicher- und Wiedergabebedürfnissen ab. Alle Formate enthalten ein unsichtbares Wasserzeichen, das die synthetische Herkunft der Audiodatei kennzeichnet.
Wie viele Stimmen gibt es?
Es stehen insgesamt 8 verschiedene Stimmen zur Verfügung. Diese umfassen vier weibliche Stimmen (aria, nova, luna, sage) und vier männliche Stimmen (felix, milo, atlas, orion). Jede Stimme kann jeden der 23 unterstützten Sprachen sprechen. Die Auswahl erfolgt über das Feld voice in der API-Anfrage.
Kann ich die Geschwindigkeit ändern?
Ja, die Geschwindigkeit ist über den Parameter speed einstellbar. Der Wertebereich liegt zwischen 0,25 und 4,0. Ein höherer Wert beschleunigt die Wiedergabe, ein niedrigerer verlangsamt sie. Dies ermöglicht eine Anpassung an verschiedene Inhalte und Zielgruppen. Die Standardgeschwindigkeit entspricht der normalen Sprechgeschwindigkeit der gewählten Stimme.
Was ist das tts-1-hd Modell?
tts-1-hd ist eines der beiden verfügbaren Modelle neben tts-1. Beide Modelle nutzen die gleiche Engine und haben denselben Preis. Die Wahl des Modells erfolgt über das Feld model in der API-Anfrage. Es gibt keinen Preisunterschied zwischen den beiden Modellen, sondern nur eine technische Auswahlmöglichkeit.
Wo finde ich die Dokumentation?
Die vollständige Dokumentation finden Sie auf der Seite /docs/. Dort erhalten Sie detaillierte Informationen zu Endpunkten, Parametern und Fehlercodes. Die API-Referenz enthält alle technischen Spezifikationen für die Integration. Für Fragen zur Nutzung und zu technischen Details können Sie die E-Mail-Supportadresse nutzen.
Erste Anfrage
curl
curl https://api.77ff.info/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.77ff.info/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.77ff.info/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
Der Zugriff auf die TTS-API beginnt mit der Erstellung eines Kontos auf 77ff.info. Registrieren Sie sich über die Seite /get-api-key/ mittels Google oder einer E-Mail-Adresse mit Passwort. Das Konto ist standortabhängig und wird für die Generierung von Audioinhalten verwendet.
Registrierung auf der Website
Besuchen Sie die Registrierungsseite, um Ihr Konto zu erstellen. Die Nutzung der API ist ausschließlich an ein bestehendes Konto gebunden. Nach der Anmeldung erhalten Sie Zugriff auf das Dashboard, in dem Ihre API-Details und Ihr Guthaben angezeigt werden.
Erster API-Schlüssel
Nach der Registrierung wird Ihnen automatisch ein API-Schlüssel im Format tts-... zugewiesen. Dieser Schlüssel ist der einzige aktive Zugang für Ihr Konto. Er wird im Dashboard unter der Sektion „API-Schlüssel“ angezeigt und kann sofort für erste Anfragen verwendet werden.
Schlüssel verwalten
Sie können jederzeit einen neuen API-Schlüssel ausstellen. Bei Ausgabe eines neuen Schlüssels wird der vorherige Schlüssel sofort ungültig. Dies ermöglicht eine einfache Trennung von Berechtigungen, falls das alte Schlüsselmaterial bekannt geworden ist. Der neue Schlüssel wird direkt im Dashboard bereitgestellt.
- Nur ein Schlüssel ist pro Konto aktiv.
- Neue Schlüssel machen den alten sofort ungültig.
- Schlüssel können über das Dashboard neu generiert werden.
Erste Anfrage
Die Generierung von Audioinhalten beginnt mit einer einfachen POST-Anfrage an den API-Endpunkt. Nach dem Erhalt Ihres API-Schlüssels können Sie direkt mit der Integration in Ihr WordPress-Plugin oder Ihre Blog-Infrastruktur beginnen. Die Struktur der Anfrage ist dabei standardisiert und einfach zu implementieren.
Der folgende Abschnitt erklärt die korrekte JSON-Struktur und liefert ein funktionierendes cURL-Beispiel, das Sie sofort in Ihrer Entwicklungsumgebung testen können. Achten Sie darauf, den korrekten Base URL und Ihren persönlichen Schlüssel zu verwenden.
cURL Befehl Beispiel
Dieses Beispiel zeigt eine minimale Anfrage zur Generierung einer Audiodatei. Ersetzen Sie tts-ihren-schlssel-hier durch Ihren tatsächlichen API-Schlüssel und passen Sie den Text sowie die Stimme nach Bedarf an.
curl -X POST "https://api.77ff.info/v1/audio/speech" \ -H "Authorization: Bearer tts-ihren-schlssel-hier" \ -H "Content-Type: application/json" \ -d '{"model": "tts-1", "input": "Hallo Welt", "voice": "nova", "response_format": "mp3"}'
JSON Struktur
Der Anfragekörper (Body) muss im JSON-Format übermittelt werden. Das Feld input enthält den maximal 4096 Zeichen langen Text. Der model-Parameter akzeptiert entweder tts-1 oder tts-1-hd. Der voice-Parameter erwartet einen der acht verfügbaren Stimmen-Namen.
Das Feld response_format bestimmt das Ausgabeformat (mp3, wav, opus, flac, pcm). Optional können Sie speed (0.25–4.0) und language (ISO-Code) spezifizieren. Wenn keine Sprache angegeben wird, versucht die API eine automatische Erkennung, wobei lateinische Schrift standardmäßig Englisch voraussetzt.
- model: tts-1 oder tts-1-hd
- input: Max. 4096 Zeichen
- voice: Eine der 8 Presets (z.B. nova, aria)
- response_format: mp3, wav, opus, flac, pcm
- speed: 0.25 bis 4.0 (optional)
Antwort format
Bei erfolgreicher Verarbeitung liefert die API die Audiodaten direkt im gewählten Format zurück. Die Antwort enthält den binären Audioinhalt sowie HTTP-Header, die Metadaten wie die Content-Type und Content-Disposition beinhalten.
Das generierte Audio wird nicht auf unseren Servern gespeichert, sondern direkt in der Antwort zurückgegeben. Dies ermöglicht eine nahtlose Einbindung in WordPress-Websites, ohne dass zusätzliche Speicherprozesse für die Zwischenspeicherung erforderlich sind.
OpenAI SDK Kompatibilität
Die API ist mit den OpenAI-SDKs kompatibel, wodurch Entwickler die bewährten Bibliotheken direkt nutzen können. Durch eine einfache Anpassung der Base URL auf https://api.77ff.info/v1 funktioniert die Standard-Logik unverändert.
Base URL Anpassung
Um die API zu nutzen, ändern Sie den Basis-Endpunkt Ihrer Konfiguration. Ersetzen Sie den Standard-Wert durch https://api.77ff.info/v1. Der Pfad /v1/audio/speech bleibt identisch zur OpenAI-Struktur.
Bibliotheken nutzen
Sie können die offiziellen OpenAI-SDKs für Python, Node.js oder andere Sprachen verwenden. Keine zusätzliche Middleware ist erforderlich. Die Authentifizierung erfolgt über den Header 'Authorization: Bearer' mit Ihrem API-Schlüssel.
- Unterstützte Sprachen: Python, JavaScript, Ruby, Go
- Keine eigenen Wrapper notwendig
- Standard-JSON-Struktur wird erwartet
Code Beispiele
Ein minimales Python-Skript generiert Audio aus Text. Setzen Sie den Base URL in der Client-Initialisierung. Die Methode 'audio.speech' ruft den Endpunkt auf und speichert die Ausgabe.
Das Skript behandelt die Authentifizierung automatisch über den konfigurierten Schlüssel. Dies ermöglicht eine schnelle Integration in WordPress-Plugins oder Blog-Plugins ohne komplexe Anpassungen.
Parameter verstehen
Die API erfordert die Angabe von Modell, Stimme, Format und optionaler Sprache. Diese Parameter steuern die Ausgabequalität und die Kompatibilität mit Ihrem Blog-System. Die Wahl des Modells beeinflusst nicht die Kosten, während das Format die Wiedergabe auf verschiedenen Endgeräten bestimmt.
Jeder Parameter muss im JSON-Body der POST-Anfrage an /v1/audio/speech enthalten sein. Die Kombination aus Textlänge und gewähltem Format bestimmt die Größe der Audiodatei. Eine korkte Konfiguration stellt sicher, dass die Audioinhalte nahtlos in WordPress-Shortcodes oder benutzerdefinierte Felder eingebunden werden können.
Modell Auswahl
Verwenden Sie 'tts-1' für Standardqualität oder 'tts-1-hd' für höhere Audioqualität. Beide Modelle nutzen dieselbe Engine und verursachen identische Kosten. Die Wahl hängt von der gewünschten Lautstärke und Klarheit im Blog-Post ab.
- 'tts-1': Standardmodell, kosteneffizient
- 'tts-1-hd': Höhere Qualität, gleiche Preise
- Beide Modelle unterstützen alle 8 Stimmen
- Keine Preisunterschiede bei der Generierung
Stimmen Parameter
Wählen Sie eine der 8 verfügbaren Stimmen aus. Die Stimme 'aria' eignet sich gut für narrativen Blog-Inhalt, während 'atlas' für Nachrichtenbeiträge geeignet ist. Jede Stimme kann jede der 23 unterstützten Sprachen sprechen. Die Sprache wird automatisch erkannt, kann aber explizit gesetzt werden.
Die Stimme wird im JSON-Feld 'voice' als String übergeben. Die Wahl der Stimme beeinflusst nicht die Kosten oder die Generierungsgeschwindigkeit. Alle Stimmen sind sofort verfügbar und erfordern keine zusätzliche Konfiguration.
- aria: Warme, klare Erzählerin
- nova: Hell, energiegeladen
- luna: Sanft, für Geschichten
- sage: Ruhig, lehrreich
- felix: Energetisch, Promotion
- milo: Freundlich, konversational
- atlas: Neutral, Nachrichten
- orion: Tief, Dokumentation
Format Einstellungen
Wählen Sie das Ausgabeformat basierend auf der Kompatibilität Ihres Blog-Players. MP3 ist weit verbreitet und wird von den meisten Browsern unterstützt. WAV bietet unverlustbehaftete Qualität für professionelle Podcasts. Opus und FLAC bieten komprimierte bzw. verlustfreie Alternativen.
Das Format wird im Feld 'response_format' angegeben. Die Dateigröße variiert stark zwischen den Formaten. MP3-Dateien sind kleiner und laden schneller auf langsamen Verbindungen. FLAC-Dateien sind größer, aber qualitativ hochwertiger.
- mp3: Weit verbreitet, klein
- wav: Unverlustbehaftet, groß
- opus: Effiziente Komprimierung
- flac: Verlustfrei, groß
- pcm: Rohdaten, sehr groß
- Keine automatische Konvertierung
Fehlerbehandlung
Die API gibt bei fehlendem Guthaben oder ungültigen Parametern einen HTTP-Fehlerstatus zurück. Bei Synthesefehlern wird der Betrag vollständig erstattet, sodass Sie keine Kosten für fehlgeschlagene Anfragen tragen.
HTTP Status Codes
Ein 402-Statuscode signalisiert, dass Ihr Guthaben nicht ausreicht. Ein 429-Status tritt auf, wenn das Ratenlimit von 60 Anfragen pro Minute überschritten wird. Weitere Fehlercodes können auf ungültige JSON-Strukturen oder nicht unterstützte Parameter hinweisen.
- 200: Erfolgreiche Generierung
- 400: Ungültige Anfrage
- 401: Ungültiger API-Schlüssel
- 402: Guthaben erschöpft
- 429: Ratenlimit erreicht
Fehlermeldungen lesen
Die Antwort enthält ein JSON-Objekt mit einer klaren Fehlermeldung. Diese beschreibt präzise, warum die Synthese fehlgeschlagen ist, beispielsweise bei Textlängen über 4096 Zeichen oder bei ungültigen Stimmen-IDs.
- Prüfen Sie das 'message'-Feld in der JSON-Antwort
- Kontrollieren Sie die Länge des Eingabetexts
- Vergewissern Sie sich, dass der API-Schlüssel aktiv ist
Retry Logik
Implementieren Sie exponentielles Backoff für 429-Fehler, um Überlastung zu vermeiden. Bei 500er-Fehlern kann ein sofortiger Retry sinnvoll sein. Wiederholen Sie keine Anfragen mit ungültigen Parametern ohne Korrektur.
- Verwenden Sie exponentielles Backoff
- Begrenzen Sie die maximale Retry-Anzahl
- Protokollieren Sie Fehler für die Fehlersuche

Ratenlimits
Die API begrenzt die Anzahl der gleichzeitigen Anfragen, um die Stabilität bei hohem Aufkommen zu gewährleisten. Pro API-Schlüssel sind standardmäßig 60 Requests pro Minute erlaubt. Dieser Grenzwert gilt für alle Endpunkte zusammen. Bei kurzzeitigen Spitzen kann die Verarbeitungslänge variieren, da Anfragen nacheinander abgearbeitet werden.
Das Limit bezieht sich auf die Anzahl der gesendeten Anfragen. Bei Überlastung können Anfragen in eine Warteschlange eintreten, was die Antwortzeit verlängert. Langfristige Begrenzungen durch das Guthaben oder die Kontotypen existieren nicht.
60 Anfragen pro Minute
Jeder API-Schlüssel erlaubt maximal 60 Anfragen pro Minute. Dieses Limit gilt unabhängig vom gewählten Modell oder Format. Wenn Sie mehrere WordPress-Plugins parallel betreiben, teilen Sie sich dieses Kontinget.
Die Zählung beginnt bei Eingangs der POST-Anfrage. Wenn Sie mehr als 60 Texte pro Minute anfordern, erhalten Sie einen HTTP-Fehler 429 (Too Many Requests). Warten Sie kurz, bis das Limit zurückgesetzt ist, und wiederholen Sie die Anfrage.
- 60 Requests/Minute pro Schlüssel
- Zählt alle POST-Anfragen
- Betrifft auch /v1/voices
Startlimit 10/min
Neue Konten starten mit einem reduzierten Limit von 10 Anfragen pro Minute. Dies gilt, solange kein Guthaben vorhanden ist. Das Limit erhöht sich automatisch auf 60/min, sobald Sie Ihre erste Top-up-Transaktion durchführen. Die Änderung tritt innerhalb weniger Minuten ein.
Dieses Startlimit verhindert Missbrauch in der Testphase. Sie können das Limit jedoch sofort aufheben, indem Sie mindestens 5 USDT auf Ihr Konto überweisen. Die Erhöhung erfolgt automatisch nach Bestätigung der Blockchain-Transaktion.
- Neue Konten: 10/min
- Ersttop-up: +5 USDT nötig
- Automatische Anpassung
Guthabenabhängigkeit
Das Ratenlimit ist nicht vom Kontostand abhängig, solange Guthaben vorhanden ist. Sogar bei einem leeren Konto nach einem Top-up gelten weiterhin 60/min. Das Limit wird nur bei Neuanmeldungen ohne Guthaben auf 10/min gesetzt.
Es gibt keine monatlichen Obergrenzen für die Gesamtmenge der Anfragen. Sie können beliebig viele Texte generieren, solange Sie das Guthaben aufladen. Das Limit pro Minute bleibt konstant, unabhängig von der Lautstärke Ihrer Blog-Aufrufe.
- Kein monatliches Limit
- Unabhängig vom Kontostand
- Keine zeitliche Begrenzung
Audio Formate
Die API unterstützt fünf Audioformate, die über das Feld response_format gewählt werden können. Die Auswahl beeinflusst ausschließlich die Dateigröße und Kompatibilität, nicht die Sprachqualität der synthetischen Stimme.
MP3 Support
MP3 ist das Standardformat für die meisten Blog-Integrationen. Es bietet eine gute Balance zwischen Dateigröße und Universalität. Alle modernen Browser und WordPress-Mediienbibliotheken unterstützen dieses Format ohne zusätzliche Plugins.
- Ideal für Web-Embeds und Mobile-First-Designs
- Kompakte Dateigröße spart Bandbreite
- Standard-konform für HTML5 Audio-Tags
WAV Support
WAV bietet verlustfreie Audioqualität. Es eignet sich gut für lokale Archivierung oder weitere Verarbeitungsschritte in einem eigenen CMS. Die Dateien sind jedoch deutlich größer als MP3-Entsprechungen.
- Unkomprimiertes Audio für höchste Treue
- Geeignet für nachgelagerte Bearbeitungsschritte
- Größere Dateigrößen im Vergleich zu MP3
Opus und FLAC
Opus bietet eine hohe Kompression bei guter Qualität, FLAC ist verlustfrei. Beide Formate sind optional und können bei Bedarf angefordert werden. Die Wahl hängt von den Speicherlimits und Wiedergabeanforderungen der Zielplattform ab.
- Opus: Hohe Effizienz bei niedriger Bitrate
- FLAC: Verlustfreie Kompression für Archivzwecke
- Beide Formate über
response_formatkonfigurierbar
Zusätzliche Endpunkte
Die API bietet zwei zusätzliche Endpunkte, um die verfügbaren Ressourcen und Modelle programmatisch abzufragen. Dies ermöglicht eine dynamische Benutzeroberfläche in WordPress-Plugins, in der Nutzer Stimmen und Sprachoptionen auswählen können, ohne den API-Endpunkt hart zu kodieren.
Stimmenliste abfragen
Der Endpunkt GET /v1/voices liefert eine Liste aller acht verfügbaren Stimmen mit ihren jeweiligen Metadaten. Dazu gehören Name, Geschlecht, unterstützte Sprachen und das Preisverhältnis. Diese Daten können genutzt werden, um ein Dropdown-Menü in einem Blog-Plugin zu füllen.
- Name der Stimme (z. B. 'aria', 'nova')
- Kategorie (männlich/weiblich)
- Unterstützte ISO-Sprachcodes
- Format-Unterstützung
Modelle abfragen
Über GET /v1/models können das Standardmodell tts-1 und das hochwertige Modell tts-1-hd abgerufen werden. Beide Modelle nutzen denselben Engine-Hintergrund und haben identische Preise, unterscheiden sich jedoch in der Audioqualität. Die Abfrage bestätigt die Verfügbarkeit der Modelle auf der Infrastruktur.
- Modell-ID
- Typ
- Verfügbarkeitsstatus
Verfügbare Daten
Die Antwort der Endpunkte enthält strukturierte JSON-Daten, die direkt in WordPress-Shortcodes oder PHP-Skripte integriert werden können. Dies gewährleistet, dass die Auswahl der Stimme und des Formats immer auf dem aktuellen Stand der API ist, ohne dass Plugin-Entwickler die Daten manuell pflegen müssen.
Hören Sie sich die 8 Stimmen an
Jede der folgenden Samples wurde von dieser API aus demselben Satz generiert. Nutzen Sie den folgenden Befehl, um eine erste Synthese anzustoßen.
23 Sprachen
Jede Stimme kann jede dieser Sprachen sprechen.
