Guide de démarrage rapide de l'API TTS
Ce guide de démarrage rapide montre comment intégrer notre API de complétions de chat sans censure dans votre pipeline TTS. Utilisez l'endpoint compatible OpenAI pour générer des scripts, des sous-titres et des dialogues sans refus de contenu.
https://api.ttsapihub.com/v1
URL de base et authentification
Commencez par configurer votre client pour qu'il pointe vers notre URL de base : https://api.ttsapihub.com/v1. Notre API est entièrement compatible OpenAI, vous pouvez donc utiliser des SDK standard en mettant simplement à jour l'base_url et en fournissant votre clé API. L'authentification est gérée via l'en-tête Authorization avec un jeton Bearer. Vous générez une clé unique lors de l'inscription sur la page Obtenir la clé API. Chaque compte est limité à une clé active, que vous pouvez régénérer à tout moment. Vos prompts ne sont pas utilisés pour l'entraînement, et aucun numéro de téléphone ou carte bancaire n'est requis pour commencer avec le crédit d'essai.
Générer du texte avec les complétions de chat
Envoyez une requête POST /v1/chat/completions standard pour générer du texte. L'ID du modèle à utiliser est uncensored. Ce modèle est un LLM à poids ouverts ajusté pour répondre sans refus de contenu pour une utilisation adulte légale, ce qui le rend idéal pour les scripts créatifs ou les dialogues où les filtres d'entreprise pourraient bloquer votre contenu. Il ne génère pas d'audio, d'images ou de vidéos ; il produit du texte pur que votre pipeline TTS peut traiter. Vous pouvez ajuster des paramètres comme temperature et max_tokens selon les besoins. L'API prend en charge l'appel de fonctions pour l'extraction de données structurées, vous permettant de formater les réponses pour votre application.
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."}]
}'
Intégration du SDK Python
Pour les développeurs Python, le SDK officiel openai fonctionne directement avec une configuration minimale. Initialisez le client avec votre URL de base et votre clé API, puis appelez chat.completions.create(). Cette approche vous permet de tirer parti des clients compatibles OpenAI existants tout en bénéficiant de notre modèle sans censure. La réponse inclut le texte généré, que vous pouvez alimenter directement dans votre moteur de synthèse vocale. Rappelez-vous qu'il s'agit d'une API textuelle uniquement, vous gérez donc la génération audio séparément dans votre 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)
Intégration du SDK Node.js
Les développeurs Node.js peuvent utiliser le package npm openai avec la même configuration que Python. Définissez l'baseURL sur notre endpoint et fournissez votre clé API. Appelez l'endpoint de complétions avec l'ID de modèle uncensored. Cette intégration est simple et vous permet d'intégrer notre génération de texte directement dans vos services TTS Node.js existants. L'API répond avec du JSON standard, ce qui facilite l'analyse et le traitement du texte généré pour les besoins de votre application.
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);
Réponses en streaming via SSE
Pour une latence plus faible, activez le streaming en définissant stream: true dans votre requête. L'API renvoie des Server-Sent Events (SSE) contenant des morceaux de texte incrémentaux. Cela est particulièrement utile pour la génération de contenu long, car les utilisateurs peuvent voir le texte apparaître en temps réel. La réponse en streaming suit le format standard SSE d'OpenAI, vous pouvez donc utiliser des analyseurs de flux existants. Cette approche réduit les temps d'attente perçus et permet à votre application d'afficher le texte au fur et à mesure de sa génération, améliorant l'expérience utilisateur pour votre pipeline TTS.
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)
Limites, erreurs et fenêtre de contexte
Votre clé API est limitée à 300 requêtes par minute et à un corps de requête de 8 Mo. Le modèle prend en charge une fenêtre de contexte de 100 000 tokens, permettant de traiter de longs scripts ou documents. Les erreurs courantes incluent 401 (clé invalide), 402 (crédit insuffisant) et 429 (limite de débit). Si vous atteignez la limite de débit, implémentez une rétrogradation exponentielle. La tarification est transparente : 0,25 $ par 1M de tokens d'entrée et 1,00 $ par 1M de tokens de sortie. Les crédits sont prépayés, n'expirent jamais et les recharges commencent à 10 $. Un nouveau compte reçoit un crédit d'essai gratuit de 0,50 $ valable 7 jours, sans carte requise. Les limites de contenu bloquent uniquement le contenu sexuel impliquant des mineurs ; tous les autres sujets adultes légaux, fictifs ou controversés sont autorisés.
Fonctions et limites
Toutes les limites et fonctions réelles de l'API au même endroit — vérifiez-les avant de recharger.
| Élément | Valeur |
|---|---|
| Format | compatible OpenAI : tout SDK OpenAI fonctionne en changeant la base URL et la clé |
| Endpoints | POST /v1/chat/completions · GET /v1/models |
| ID du modèle | uncensored |
| Authentification | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.ttsapihub.com/v1 |
| Fenêtre de contexte | 100 000 tokens (entrée + sortie) |
| Streaming | oui — server-sent events ; le dernier bloc contient l'usage des tokens |
| Mode JSON | response_format: {"type": "json_object"} |
| Paramètres | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Appel de fonctions | oui — tools, tool_choice ; réponse avec tool_calls, aussi en streaming ; résultats en role: tool |
| Sortie max. | jusqu'au reste de la fenêtre de 100 000 tokens ; max_tokens optionnel (pas de plafond distinct) |
| En-têtes | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Concurrence | 8 requêtes simultanées par clé |
| Taille | jusqu'à 8 Mo par requête |
| Limite de débit | 300 requêtes par minute et par clé |
| Facturation | crédit prépayé selon l'usage réel ; erreurs et refus gratuits |
| Bonus | +5 % dès 50 $, +10 % dès 100 $ |
| Prix | 0,25 $ par million de tokens en entrée · 1,00 $ par million en sortie |
| Recharge | USDT (TRC20) ou USDC (Base), tout montant entier de 10 $ à 500 $ |
| Validité | le crédit payé n'expire jamais, sans abonnement |
| Essai gratuit | 0,50 $ pendant 7 jours, sans carte · Clé d'essai : 2 requêtes parallèles, 60 par minute ; limites complètes (8 et 300) après la 1re recharge |
| Contenu | contenu adulte autorisé ; tout contenu sexuel impliquant des mineurs est refusé |
| Clés | une clé active par compte ; une nouvelle remplace l'ancienne |
| Connexion | Google ou e-mail et mot de passe |
Codes d'erreur
Les erreurs arrivent en JSON avec un type stable ; les requêtes échouées ou refusées ne sont pas facturées.
| Code | Type | Signification |
|---|---|---|
400 | bad_request | JSON invalide, messages vides, mauvais paramètre ou contexte trop long |
401 | missing_key · invalid_key · key_revoked | clé absente, erronée ou remplacée |
402 | no_credit | plus de crédit — rechargez, la reprise est immédiate |
403 | content_blocked | contenu sexuel impliquant des mineurs — refusé, non facturé |
404 | not_found | endpoint inconnu |
413 | request_too_large | corps supérieur à 8 Mo |
429 | rate_limited · concurrency | au-delà de 300/min ou 8 en parallèle — patientez |
503 | upstream_busy | modèle occupé — réessayez dans quelques secondes |
Questions et réponses
Cette API génère-t-elle de l'audio ?
Non, il s'agit d'une API textuelle uniquement. Elle génère le script ou le dialogue texte, que vous envoyez ensuite à un moteur TTS séparé pour la synthèse audio. Elle ne produit pas de fichiers audio, image ou vidéo.
Comment commencer à utiliser l'API ?
Inscrivez-vous sur la page Obtenir la clé API avec un e-mail et un mot de passe. Vous recevez immédiatement une clé API et un crédit d'essai gratuit de 0,50 $ valable 7 jours. Aucune carte bancaire ni numéro de téléphone n'est requis pour commencer.
Quelle est la taille de la fenêtre de contexte ?
Le modèle prend en charge une fenêtre de contexte de 100 000 tokens, qui inclut à la fois le prompt d'entrée et la complétion de sortie. Cela permet de traiter de longs documents ou de conserver un historique de conversation étendu dans votre pipeline.
Votre clé est à un formulaire de vous
Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.