TTS API-snelstartgids
Deze snelstartgids laat zien hoe je onze ongekensureerde chat-completions API integreert in je TTS-pipeline. Gebruik het OpenAI-compatibele endpoint om scripts, ondertitels en dialoog te genereren zonder inhoudsfilters.
https://api.ttsapihub.com/v1
Base URL en authenticatie
Configureer je client eerst zodat deze naar onze base URL wijst: https://api.ttsapihub.com/v1. Onze API is volledig OpenAI-compatibel, dus je kunt standaard SDK's gebruiken door simpelweg de base_url aan te passen en je API-sleutel te verstrekken. Authenticatie verloopt via de Authorization header met een Bearer token. Je genereert een unieke sleutel tijdens het aanmaken van een account op de pagina API-sleutel ophalen. Elk account is beperkt tot één actieve sleutel, die je op elk moment kunt regenereren. Je prompts worden niet gebruikt voor training en er is geen telefoonnummer of creditcard nodig om met het gratis proeftegoed te beginnen.
Tekst genereren met chat-completies
Stuur een standaard POST /v1/chat/completions verzoek om tekst te genereren. Het te gebruiken model-ID is uncensored. Dit model is een open-weight LLM die is afgestemd op het beantwoorden zonder inhoudsfilters voor wettelijk volwassen gebruik, wat het ideaal maakt voor creatieve scripts of dialoog waar bedrijfsfilters je inhoud zouden blokkeren. Het genereert geen audio, beelden of video; het geeft pure tekst uit die je TTS-pipeline kan verwerken. Je kunt parameters aanpassen zoals temperature en max_tokens naar behoefte. De API ondersteunt function calling voor gestructureerde gegevensextractie, zodat je antwoorden kunt formatteren voor je applicatie.
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": "Write a blunt product review of a cheap VPN."}]
}'
Python SDK-integratie
Voor Python-ontwikkelaars werkt de officiële openai SDK direct met minimale configuratie. Initialiseer de client met je base URL en API-sleutel en roep vervolgens chat.completions.create() aan. Deze aanpak stelt je in bestaande OpenAI-compatibele clients te gebruiken terwijl je profiteert van ons ongekensureerde model. Het antwoord bevat de gegenereerde tekst, die je direct kunt voeden in je speech synthesis engine. Onthoud dat dit een tekst-API is, dus je behandelt audiogeneratie apart in je pipeline.
from 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": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
Node SDK-integratie
Node.js-ontwikkelaars kunnen het openai npm-pakket gebruiken met dezelfde configuratie als Python. Stel de baseURL in op ons endpoint en verstrek je API-sleutel. Roep het completions-endpoint aan met het model-ID uncensored. Deze integratie is eenvoudig en stelt je in onze tekstgeneratie direct te integreren in je bestaande Node.js TTS-diensten. De API reageert met standaard JSON, waardoor het eenvoudig is de gegenereerde tekst te parseren en te verwerken voor de behoeften van je applicatie.
import 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: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
Streaming-antwoorden via SSE
Schakel streaming in voor lagere latentie door stream: true in je verzoek in te stellen. De API retourneert Server-Sent Events (SSE) met incrementele tekstchunks. Dit is vooral nuttig voor het genereren van lange inhoud, omdat gebruikers tekst in real-time kunnen zien verschijnen. Het streaming-antwoord volgt de standaard OpenAI SSE-indeling, dus je kunt bestaande stream-parsers gebruiken. Deze aanpak vermindert de waargenomen wachttijden en stelt je applicatie in tekst weer te geven terwijl deze wordt gegenereerd, wat de gebruikerservaring voor je TTS-pipeline verbetert.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Limieten, fouten en contextvenster
Je API-sleutel is beperkt tot 300 verzoeken per minuut en een verzoeklichaam van 8 MB. Het model ondersteunt een contextvenster van 100.000 tokens, waardoor je lange scripts of documenten kunt verwerken. Veelvoorkomende fouten zijn 401 (ongeldige sleutel), 402 (onvoldoende tegoed) en 429 (rate limit). Als je de rate limit bereikt, implementeer dan exponentiële backoff. Prijzen zijn transparant: $0,25 per 1M invoertokens en $1,00 per 1M uitvoertokens.tegoed is prepaid, vervalt nooit en opwaarderingen beginnen bij $10. Een nieuw account ontvangt $0,50 aan gratis proeftegoed dat 7 dagen geldig is, zonder dat je een creditcard nodig hebt. Contentlimieten blokkeren alleen seksuele inhoud met minderjarigen; alle andere wettelijke volwassen, fictieve of controversiële onderwerpen zijn toegestaan.
Technische specificaties
Alle echte limieten en functies van de API op één plek — controleer ze voordat je opwaardeert.
| Onderdeel | Waarde |
|---|---|
| API-formaat | OpenAI-compatibel: elke OpenAI-SDK werkt — vervang alleen base URL en sleutel |
| Endpoints | POST /v1/chat/completions · GET /v1/models |
| Model-ID | uncensored |
| Authenticatie | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.ttsapihub.com/v1 |
| Contextvenster | 100.000 tokens (invoer + uitvoer) |
| Streaming | ja — server-sent events; het laatste deel bevat het tokenverbruik |
| JSON-modus | response_format: {"type": "json_object"} |
| Parameters | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Function calling | ja — tools, tool_choice; antwoorden bevatten tool_calls, ook bij streaming; resultaten als role: tool |
| Max. uitvoer | tot de rest van het venster van 100.000 tokens; max_tokens optioneel (geen aparte limiet) |
| Responsheaders | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Gelijktijdige verzoeken | tot 8 tegelijk per sleutel |
| Verzoekgrootte | tot 8 MB |
| Rate limit | 300 verzoeken per minuut per sleutel |
| Afrekening | prepaid tegoed op basis van echt verbruik; fouten en weigeringen zijn gratis |
| Bonus | +5% vanaf $50, +10% vanaf $100 |
| Prijs | $0,25 per 1 mln invoertokens · $1,00 per 1 mln uitvoertokens |
| Opwaarderen | USDT (TRC20) of USDC (Base), elk heel bedrag van $10 tot $500 |
| Geldigheid | betaald tegoed verloopt niet, geen abonnement |
| Gratis proeftegoed | $0,50 voor 7 dagen, zonder kaart · Proefsleutel: 2 parallelle verzoeken, 60 per minuut; volledige limieten (8 en 300) na eerste opwaardering |
| Inhoud | inhoud voor volwassenen toegestaan; seksuele inhoud met minderjarigen wordt geweigerd |
| Sleutels | één actieve sleutel per account; een nieuwe vervangt de oude |
| Inloggen | Google of e-mail en wachtwoord |
Foutcodes
Fouten komen als JSON met een vaste type; mislukte of geweigerde verzoeken kosten niets.
| Code | Type | Betekenis |
|---|---|---|
400 | bad_request | ongeldige JSON, lege berichten, verkeerde parameter of context te lang |
401 | missing_key · invalid_key · key_revoked | sleutel ontbreekt, is onjuist of is vervangen |
402 | no_credit | geen tegoed — waardeer op en ga direct verder |
403 | content_blocked | seksuele inhoud met minderjarigen — geweigerd, niet gerekend |
404 | not_found | onbekend endpoint |
413 | request_too_large | body groter dan 8 MB |
429 | rate_limited · concurrency | meer dan 300/min of 8 tegelijk — wacht en probeer opnieuw |
503 | upstream_busy | model bezet — probeer het over enkele seconden opnieuw |
Vragen en antwoorden
Genereert deze API audio?
Nee, dit is een API die alleen tekst verwerkt. Hij genereert het tekstscript of de dialoog, die je vervolgens naar een aparte TTS-engine stuurt voor audiogeneratie. Hij produceert geen audio-, afbeeldings- of videobestanden.
Hoe begin ik met de API?
Meld je aan op de pagina API-sleutel ophalen met een e-mailadres en wachtwoord. Je ontvangt direct een API-sleutel en $0,50 aan gratis proeftegoed dat 7 dagen geldig is. Er is geen creditcard of telefoonnummer nodig om te beginnen.
Wat is de grootte van het contextvenster?
Het model ondersteunt een contextvenster van 100.000 tokens, dat zowel de ingevoerde prompt als de gegenereerde tekst omvat. Dit stelt je in staat lange documenten te verwerken of een uitgebreide gespreksgeschiedenis te onderhouden in je pipeline.
Je sleutel is nog maar één formulier verwijderd
Maak een account aan, kopieer de sleutel en pas de base URL aan. Dat is de hele installatie.