Guida rapida per pipeline Xtts

Autenticazione e Base URL

Inizia navigando verso la pagina Ottieni chiave API ed accedi con Google o una password email. Riceverai immediatamente una chiave API univoca. Utilizza il Base URL https://api.xtts.cc/v1 per tutte le richieste. Questo URL è compatibile con gli SDK ufficiali OpenAI e con qualsiasi client che supporta il formato chat-completions OpenAI.

Includi la tua chiave nell'intestazione Authorization come token bearer. L'identificatore del modello che devi inviare è uncensored. Questo modello a pesi aperti è ospitato sui nostri server ed è ottimizzato per rispondere senza rifiuti sui contenuti per uso adulto lecito, garantendo che la tua pipeline vocale riceva il testo grezzo di cui ha bisogno.

Genera testo senza censura

Invia una richiesta POST a /v1/chat/completions con i tuoi prompt di sistema e utente. L'API restituisce un JSON strutturato contenente il testo generato. Questo endpoint è progettato per la scrittura di prompt, la generazione di script e le attività di post-elaborazione nel tuo flusso di lavoro di clonazione vocale.

Il corpo della richiesta include il nome del modello, la cronologia dei messaggi e parametri opzionali come temperature o top_p. Puoi controllare la lunghezza dell'output con il parametro max_tokens. Se non imposti max_tokens, la risposta può estendersi fino alla fine della finestra di contesto.

Copiacurl https://api.xtts.cc/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

Utilizza l'SDK Python ufficiale OpenAI per interagire con la nostra API. Imposta il base_url sul nostro endpoint e fornisci la tua chiave API. Questo approccio ti permette di sfruttare le strutture di codice esistenti beneficiando al contempo del comportamento del nostro modello senza censura.

Crea un'istanza del client con l'URL di base e poi chiama chat.completions.create. Passa l'ID del modello uncensored e i tuoi messaggi. L'oggetto di risposta contiene il testo generato in content. Questo metodo è ideale per script di elaborazione batch o per integrare la generazione di testo in applicazioni Python più grandi.

Copiafrom openai import OpenAI

client = OpenAI(base_url="https://api.xtts.cc/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

Per gli ambienti JavaScript, usa l'SDK Node di OpenAI. Configura il client con il nostro URL di base e la chiave API. Questa configurazione ti permette di generare testo direttamente nelle tue applicazioni web o lato server.

Chiama l'endpoint delle chat completions con il modello uncensored. La risposta fornisce il testo generato, che puoi poi passare al tuo motore di sintesi vocale. Questa integrazione è adatta per la generazione di testo in tempo reale in app web o servizi backend che preparano script per la clonazione vocale.

Copiaimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.xtts.cc/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

Abilita lo streaming impostando stream su true nella tua richiesta. L'API restituisce Server-Sent Events (SSE) per ogni token generato. Questa funzione è utile per la visualizzazione del testo in tempo reale o per la preparazione progressiva della sintesi vocale.

Ogni chunk di evento contiene testo parziale. L'ultimo chunk include le statistiche di utilizzo, come i conteggi dei token. Lo streaming consente alla tua applicazione di elaborare il testo man mano che viene generato, riducendo la latenza percepita per gli utenti. Gestisci gli eventi dello stream per accumulare la risposta completa.

Copiastream = 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 di richiesta e parametri

Ogni chiave API è limitata a 300 richieste al minuto e 8 richieste parallele. Il corpo della richiesta non deve superare 8 MB. Se invii una chiave non valida, riceverai un errore 401. Se il tuo credito prepagato è esaurito, riceverai un errore 402. Il superamento del limite di richiesta comporta un errore 429.

La finestra di contesto supporta 100,000 token in totale, inclusi sia il prompt che il completamento. Non esiste un limite separato per l'output e puoi specificare un max_tokens inferiore se desideri una risposta più breve. Errori e rifiuti non consumano il tuo credito prepagato. È disponibile il supporto per la chiamata di funzioni e la modalità JSON per l'estrazione di dati strutturati.