Guida rapida all'API TTS

URL base e autenticazione

Inizia configurando il tuo client per puntare al nostro URL base: https://api.ttsapihub.com/v1. La nostra API è completamente compatibile con OpenAI, quindi puoi utilizzare SDK standard semplicemente aggiornando il base_url e fornendo la tua chiave API. L'autenticazione viene gestita tramite l'intestazione Authorization con un token Bearer. Generi una chiave univoca durante la registrazione nella pagina Ottieni chiave API. Ogni account è limitato a una chiave attiva, che puoi rigenerare in qualsiasi momento. I tuoi prompt non vengono utilizzati per l'addestramento e non è necessario un numero di telefono o una carta di credito per iniziare con il credito di prova.

Genera testo con completamenti chat

Invia una richiesta POST /v1/chat/completions standard per generare testo. L'ID del modello da utilizzare è uncensored. Questo modello è un LLM a pesi aperti ottimizzato per rispondere senza rifiuti di contenuti per l'uso adulto legale, rendendolo ideale per script creativi o dialoghi in cui i filtri aziendali potrebbero bloccare i tuoi contenuti. Non genera audio, immagini o video; produce testo puro che la tua pipeline TTS deve elaborare. Puoi regolare parametri come temperature e max_tokens secondo necessità. L'API supporta la chiamata di funzioni per l'estrazione di dati strutturati, consentendoti di formattare le risposte per la tua applicazione.

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": "Write a blunt product review of a cheap VPN."}]
  }'

Integrazione SDK Python

Per gli sviluppatori Python, l'SDK ufficiale openai funziona subito con una configurazione minima. Inizializza il client con il tuo URL base e chiave API, quindi chiama chat.completions.create(). Questo approccio ti permette di sfruttare i client compatibili con OpenAI esistenti beneficiando al contempo del nostro modello senza censura. La risposta include il testo generato, che puoi alimentare direttamente nel tuo motore di sintesi vocale. Ricorda che questo è un API solo testo, quindi gestisci la generazione audio separatamente nella tua pipeline.

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": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Integrazione SDK Node.js

Gli sviluppatori Node.js possono utilizzare il pacchetto npm openai con la stessa configurazione di Python. Imposta il baseURL sul nostro endpoint e fornisci la tua chiave API. Chiama l'endpoint dei completamenti con l'ID del modello uncensored. Questa integrazione è semplice e ti permette di integrare la nostra generazione di testo direttamente nei tuoi servizi TTS Node.js esistenti. L'API risponde con JSON standard, rendendo facile analizzare ed elaborare il testo generato per le esigenze della tua applicazione.

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: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Risposte in streaming tramite SSE

Per una latenza inferiore, abilita lo streaming impostando stream: true nella tua richiesta. L'API restituisce Server-Sent Events (SSE) contenenti chunk di testo incrementali. Questo è particolarmente utile per la generazione di contenuti di lunga durata, poiché gli utenti possono vedere il testo apparire in tempo reale. La risposta in streaming segue il formato standard SSE di OpenAI, quindi puoi utilizzare parser di stream esistenti. Questo approccio riduce i tempi di attesa percepiti e permette alla tua applicazione di visualizzare il testo man mano che viene generato, migliorando l'esperienza utente per la tua pipeline TTS.

Copystream = 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)

Limiti, errori e finestra di contesto

La tua chiave API è limitata a 300 richieste al minuto e a un corpo di richiesta di 8 MB. Il modello supporta una finestra di contesto da 100.000 token, consentendo script o documenti lunghi. Gli errori comuni includono 401 (chiave non valida), 402 (credito insufficiente) e 429 (limite di richieste). Se raggiungi il limite di richieste, implementa un backoff esponenziale. I prezzi sono trasparenti: $0,25 per 1M di token di input e $1,00 per 1M di token di output. I crediti sono prepagati, non scadono mai e i ricaricamenti partono da $10. Un nuovo account riceve $0,50 di credito di prova valido per 7 giorni, senza necessità di carta. I limiti sui contenuti bloccano solo i contenuti sessuali che coinvolgono minori; tutti gli altri argomenti legali, adulti, di fantasia o controversi sono consentiti.