TTS-API-Base-URL: Was es ist und was du eingeben musst

Die Base-URL und eine Sache, die du zuerst wissen solltest

Wenn du hierher gekommen bist, weil du nach einer tts api base url gesucht hast, prüfe vor dem Kopieren eine Sache: Der Dienst hinter dieser Website ist eine Text-Sprachmodell-API, kein Sprachsynthesizer. Die Basis-URL ist https://api.ttsapihub.com/v1 und sie bietet POST /v1/chat/completions sowie GET /v1/models an. Es gibt keine /audio/speech-Route, keine Stimmliste und keine Audioausgabe.

Das ist wichtig, weil viele Tools ihre Einstellungen allgemein bezeichnen. Ein Feld namens Basis-URL in einem Client funktioniert auf die gleiche Weise, egal ob der Server dahinter mit Text oder Ton antwortet. Wenn dein Ziel ist, Text in Audio umzuwandeln, wird dieser Endpunkt das nicht leisten. Wenn dein Ziel ist, den Text zu generieren, den ein Sprach-Tool später vorlesen soll, etwa für Skripte, Dialoge oder Sprechertext-Entwürfe, passt es gut. Die TTS-Pipeline-Checkliste der Website ist der richtige Ort, wenn du einen solchen Workflow planst, und die Schnellstart-Dokumentation listet alle Anfrage-Parameter auf.

Der Rest dieser Seite gilt für jeden OpenAI-kompatiblen Client, also ist er nützlich, auch wenn du nur hier bist, um zu lernen, wie Base-URLs funktionieren.

Was eine Base-URL tatsächlich ist

Eine API-Adresse hat zwei Hälften. Die erste Hälfte identifiziert den Dienst und die Version seiner Schnittstelle. Die zweite Hälfte benennt die Aktion. Die Client-Bibliothek fügt sie für dich zusammen. Mit den OpenAI-SDKs sehen die Teile so aus:

Teil	Wert
Base-URL	https://api.ttsapihub.com/v1
Vom SDK angehängter Pfad für Chat	/chat/completions
Vollständige aufgerufene Adresse	https://api.ttsapihub.com/v1/chat/completions
Pfad für die Modellliste	/models

Da das SDK den Pfad anhängt, gibst du ihm nur die erste Hälfte. Das ist die ganze Idee hinter dem Wechseln der Anbieter mit einer einzeiligen Änderung: Das Anfrageformat ist geteilt, also muss sich nur der Ort ändern, an dem Anfragen gesendet werden. Der Schlüssel ändert sich auch, da jeder Dienst seinen eigenen ausstellt. Und der Modellname ändert sich, weil jeder Dienst seine eigenen Modelle benennt. Für diese API ist die Modell-ID uncensored.

Zwei kleine Details sparen Zeit. Das Versionssegment, /v1, gehört zur Basis-URL, weil es die Schnittstellengeneration markiert; eine zukünftige inkompatible Schnittstelle würde unter einer anderen Version leben, und dein Code würde sich nicht ändern, bis du dich entscheidest, zu wechseln. Und ein abschließender Slash auf der Basis-URL wird von den meisten SDKs toleriert, aber es ist sicherer, ihn wegzulassen, damit verbundene Pfade niemals einen doppelten Slash enthalten.

Authentifizierung ist ein standardmäßiger Bearer-Header: Authorization: Bearer YOUR_KEY. SDKs erstellen diesen Header aus dem Schlüssel, den du übergibst, also schreibst du ihn selten selbst, außer in curl.

Die Basis-URL im Code einstellen

Python

Das offizielle openai-Paket nimmt ein base_url-Argument. Das ist ein vollständiger Funktionsaufruf:

Copyfrom openai import OpenAI

client = OpenAI(
    base_url="https://api.ttsapihub.com/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write a two-line scene opening."}],
)
print(resp.choices[0].message.content)

Node

Copyimport OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.ttsapihub.com/v1",
  apiKey: process.env.API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a two-line scene opening." }],
});
console.log(resp.choices[0].message.content);

curl

Mit curl schreibst du die vollständige Adresse selbst, also ist der Pfad enthalten:

Copycurl https://api.ttsapihub.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "messages": [{"role": "user", "content": "Say hello."}]}'

Umgebungsvariablen

Neuere Versionen der offiziellen OpenAI-SDKs lesen OPENAI_BASE_URL und OPENAI_API_KEY aus der Umgebung, wenn du sie nicht im Code übergibst. Das ist praktisch, wenn du bestehende Software auf einen neuen Endpunkt verweisen willst, ohne sie zu bearbeiten. Setze sie in deiner Shell oder deinem Prozess-Manager, dann führe das Programm wie üblich aus. Prüfe die Dokumentation deiner SDK-Version, wenn sie sie nicht aufnimmt.

Es in Editoren und Apps einstellen

Tools, die einen benutzerdefinierten OpenAI-Endpunkt akzeptieren, fragen nach denselben drei Werten. Die Namen unterscheiden sich, also suche nach Formulierungen wie den folgenden:

• Cursor: In den Modelleinstellungen gibt es eine Option, um die OpenAI-Basis-URL zu überschreiben. Füge https://api.ttsapihub.com/v1 ein, füge deinen Schlüssel hinzu und füge uncensored als benutzerdefinierten Modellnamen hinzu. Die Beschriftungen der Oberfläche ändern sich zwischen Cursor-Versionen, also betrachte diese Namen als Richtlinie.
• SillyTavern: Wähle Chat Completion, dann die benutzerdefinierte (OpenAI-kompatible) Quelle und fülle den Endpunkt, den Schlüssel und das Modell aus.
• Open WebUI und ähnliche Chat-Frontends: Füge eine OpenAI-Verbindung mit der Basis-URL und dem Schlüssel hinzu.
• Deine eigenen Skripte: Jeder HTTP-Client funktioniert, da die Schnittstelle reines JSON über HTTPS ist.

Einige Tools prüfen die Verbindung, indem sie GET /v1/models aufrufen. Diese API unterstützt diese Route, also besteht die Prüfung. Einige Tools lassen dich nur aus einer festen Liste auswählen; wenn deines das tut, suche nach einem benutzerdefinierten oder manuellen Modellfeld statt dem Dropdown.

Denke daran, wofür das Tool gedacht ist. Ein Editor wie Cursor sendet Codefragen an ein allgemeines Chat-Modell, das funktioniert. Aber Funktionen, die spezielle Endpunkte benötigen, wie Einbettungen für die Codesuche, sind hier nicht verfügbar, da Einbettungen nicht angeboten werden.

Fehler, die die meisten Basis-URL-Fehler verursachen

Fast jeder gescheiterte erste Verbindungsversuch kommt von einem dieser.

1. Die Version verdoppeln. Die Basis-URL endet bereits in /v1. Wenn du eine weitere hinzufügst, wird die Adresse zu /v1/v1/chat/completions und der Server antwortet mit einem 404-Fehler.
2. Den vollständigen Pfad einfügen. Ein Base-URL-Feld möchte https://api.ttsapihub.com/v1, nicht https://api.ttsapihub.com/v1/chat/completions. Das SDK würde den Pfad ein zweites Mal anhängen.
3. Die Website-Adresse verwenden. Die Website, die du liest, ist nicht der API-Host. Anfragen gehen an den oben gezeigten api.-Host.
4. Eine Sprachroute aufrufen. Pfade wie /audio/speech existieren hier nicht und geben einen Fehler zurück.
5. Falscher oder fehlender Modellname. Sende immer uncensored in Kleinbuchstaben.
6. Schlüsselprobleme. Ein falsches Leerzeichen oder ein fehlendes Bearer-Präfix in einem handgeschriebenen Header gibt einen Authentifizierungsfehler.

Um ein URL-Problem von einem Schlüsselproblem zu unterscheiden, rufe die Modellliste ab. Eine korrekte URL und ein falscher Schlüssel geben einen Authentifizierungsfehler. Eine falsche URL gibt Not Found, einen DNS-Fehler oder eine HTML-Seite statt JSON zurück.

Copycurl https://api.ttsapihub.com/v1/models -H "Authorization: Bearer $API_KEY"
# then a minimal chat call with the model ID "uncensored":
curl https://api.ttsapihub.com/v1/chat/completions -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":5}'

Hole einen Schlüssel und was er kostet

Du brauchst einen Schlüssel, bevor alles funktioniert. Registriere dich mit Google oder mit E-Mail und Passwort auf der API-Schlüssel-Seite und beanspruche dann das $0,50 Testguthaben mit einem Klick. Es ist 7 Tage gültig, ein Anspruch pro Person und benötigt keine Karte. Der Test-Schlüssel erlaubt 2 parallele Anfragen und 60 Anfragen pro Minute, während ein voller Schlüssel 8 parallele und 300 pro Minute erlaubt.

Die Preise sind $0,15 pro 1M Input-Token und $0,50 pro 1M Output-Token, bezahlt aus Prepaid-Guthaben ohne Abonnement. Eine Anfrage mit 2.000 Input-Token und 500 Output-Token kostet $0,0003 plus $0,00025, also $0,00055. Aufladungen laufen von $20 bis $500 mit Boni ab $50, und du kannst mit Karte (Visa, Mastercard, Apple Pay, Google Pay) oder Krypto (USDT auf TRC20, USDC auf Base) bezahlen. Die Preisseite hat die vollständige Tabelle. Prompts werden nicht zum Training verwendet, und das Modell ist nur für die rechtmäßige Nutzung durch Erwachsene gedacht, ohne sexuellen Inhalt mit Minderjährigen.

Weitere Anleitungen

• Kostenlose API für SillyTavern: Testguthaben und Einrichtung
• TTS API-Schlüssel in Python: Einrichtung, Streaming, JSON-Modus
• Elevenlabs API-Checkliste: Unzensierte TTS-Pipeline