Snelstart voor Xtts-pipelines

Authenticatie & Base URL

Ga naar de API-sleutel ophalen-pagina en log in met Google of een e-mailwachtwoord. Je ontvangt direct een unieke API-sleutel. Gebruik de base URL https://api.xtts.cc/v1 voor alle verzoeken. Deze URL is compatibel met officiële OpenAI SDK's en elke client die het OpenAI chat-completions-formaat ondersteunt.

Voeg je sleutel toe aan de Authorization-header als bearer token. De model-ID die je moet verzenden is uncensored. Dit open-weight model wordt op onze servers gehost en is afgestemd op het geven van antwoorden zonder inhoudelijke weigeringen voor wettelijk volwassen gebruik, zodat je voice pipeline de ruwe tekst krijgt die het nodig heeft.

Ongecensureerde tekst genereren

Verzend een POST-verzoek naar /v1/chat/completions met je system- en user-prompts. De API retourneert gestructureerde JSON met de gegenereerde tekst. Dit endpoint is ontworpen voor het schrijven van prompts, scriptgeneratie en taken voor nabewerking in je voice cloning-workflow.

De request body bevat de modelnaam, je berichtgeschiedenis en optionele parameters zoals temperature of top_p. Je kunt de uitvoerlengte bepalen met de max_tokens-parameter. Als je max_tokens niet instelt, kan de response tot het einde van het contextvenster lopen.

Kopiërencurl 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."}]
  }'

Python SDK-integratie

Gebruik de officiële OpenAI Python SDK om met onze API te communiceren. Stel de base_url in op ons endpoint en geef je API-sleutel op. Deze aanpak stelt je in bestaande code-structuren te gebruiken terwijl je profiteert van het gedrag van ons ongecensureerde model.

Maak een client-instantie aan met de base URL en roep vervolgens chat.completions.create aan. Geef het uncensored model-id en je berichten door. Het response-object bevat de gegenereerde tekst in content. Deze methode is ideaal voor batch-processing scripts of het integreren van tekstgeneratie in grotere Python-applicaties.

Kopiërenfrom 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)

Node SDK-integratie

Voor JavaScript-omgevingen gebruik je de OpenAI Node SDK. Configureer de client met onze base URL en API-sleutel. Deze opstelling stelt je in staat tekst direct te genereren in je web- of server-side applicaties.

Roep het chat-completions-endpoint aan met het uncensored model. De respons bevat de gegenereerde tekst, die je vervolgens naar je voice synthesis-engine kunt sturen. Deze integratie is geschikt voor realtime tekstgeneratie in webapps of backend-services die scripts voorbereiden voor voice cloning.

Kopiërenimport 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);

Streaming-responsen

Schakel streaming in door stream in te stellen op true in je verzoek. De API retourneert Server-Sent Events (SSE) voor elke gegenereerde token. Deze functie is nuttig voor realtime tekstweergave of progressieve voorbereiding van voice synthesis.

Elk event-chunk bevat gedeeltelijke tekst. Het laatste chunk bevat gebruikstatistieken, zoals token-tellingen. Streaming zorgt ervoor dat je applicatie tekst kan verwerken terwijl deze wordt gegenereerd, wat de waargenomen latentie voor gebruikers vermindert. Verwerk de stream-events om de volledige respons op te bouwen.

Kopiërenstream = 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)

Rate limits & parameters

Elke API-sleutel is beperkt tot 300 verzoeken per minuut en 8 gelijktijdige verzoeken. De request body mag niet groter zijn dan 8 MB. Als je een ongeldige sleutel verstuurt, ontvang je een 401-fout. Als je prepaid tegoed opgebruikt is, ontvang je een 402-fout. Het overschrijden van de rate limit resulteert in een 429-fout.

Het contextvenster ondersteunt in totaal 100,000 tokens, inclusief zowel de prompt als de completion. Er is geen aparte outputlimiet en je kunt een lagere max_tokens opgeven als je een korter antwoord wilt. Fouten en weigeringen verbruiken niet je prepaid tegoed. Ondersteuning voor function calling en JSON-modus is beschikbaar voor gestructureerde gegevensextractie.