Basis-URL en authenticatie
Maak verbinding met de API via de meegeleverde basis-URL en uw API-sleutel. Dit eindpunt werkt met standaard OpenAI SDK's door eenvoudig de configuratie aan te passen. U ontvangt één actieve sleutel per account, die u genereert via Google of e-mail tijdens het aanmelden. De sleutel verifieert elk verzoek dat u naar de service stuurt.
curl https://api.hubuncensored.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Generate a JSON object with user id and role"}]
}'Houd je sleutel veilig. Als je een nieuwe genereert, wordt de vorige sleutel onmiddellijk ongeldig. Dit zorgt ervoor dat je altijd de toegang tot je voorgekochte tegoed beheert zonder achterblijvende rechten.
Chat Completions Endpoint
Stuur je promptgegevens naar het chat-completie-eindpunt voor tekstgeneratie. Dit is de primaire interface voor je applicaties, die alle tekstinvoer en -uitvoer verwerkt. Je moet het model specificeren als 'uncensored' om consistent gedrag te garanderen. De API verwerkt je verzoek en retourneert de gegenereerde tekstrespons.
from openai import OpenAI
client = OpenAI(base_url="https://api.hubuncensored.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)Fouten zoals 401 geven een ongeldige sleutel aan, terwijl 402 betekent dat je meer krediet nodig hebt. Verzoeken worden aangerekend op basis van daadwerkelijk tokengebruik, dus fouten putten je saldo niet uit.
Streaming-responsen via SSE
Ontvang tokens in real-time met behulp van Server-Sent Events (SSE). Deze methode vermindert de waargenomen latentie voor lange uitvoeren door gegevens te leveren zoals ze worden gegenereerd. Je kunt de laatste chunk parseren om nauwkeurige tokengebruiksstatistieken voor facturatie te krijgen. Streaming is ideaal voor gebruikersinterfaces waar directe feedback belangrijk is.
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)Het contextvenster staat 100.000 tokens in totaal toe, inclusief zowel prompt als completion. Streaming verandert niets aan de onderliggende tokenlimieten of prijsstructuur.
Function Calling en JSON-modus
Gebruik function calling om gestructureerde uitvoer in uw workflow te integreren. Specificeer tools en tool_choice om het responsformaat van het model te sturen. U kunt ook strikte JSON-modus afdwingen met de response_format-parameter voor betrouwbare parsering. Dit zorgt ervoor dat uw applicatie gegevens ontvangt in de exacte structuur die u definieert.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.hubuncensored.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);Deze functies werken binnen het enkele ongecensureerde model. Er is geen modelrouting of keuze tussen verschillende leveranciers. U vertrouwt op één open-weight model getuned voor onbeperkte inhoud.
Parameters: Temperatuur, Top P en Stop
Reguleer het generatiegedrag met standaardparameters zoals temperatuur en top_p. Pas deze waarden aan om een balans te vinden tussen creativiteit en determinisme in je outputs. Met de stop-parameter kun je de generatie stoppen bij specifieke sequenties. Je kunt ook presence_penalty en frequency_penalty instellen om de outputstijl te verfijnen.
Stel max_tokens in op 16.000 voor lange antwoorden. Als je max_tokens weglaat, is de standaardwaarde 2.048 tokens per verzoek. Deze instellingen geven je precieze controle over het generatieproces.
Limieten, fouten en contextvenster
Monitor uw gebruik tegen strikte snelheidslimieten om een vlotte werking te garanderen. U mag 300 verzoeken per minuut doen en 8 gelijktijdige verzoeken per sleutel. De maximale grootte van de request body is 8 MB. Het overschrijden van deze limieten retourneert een 429-snelheidslimietfout. Het begrijpen van deze beperkingen helpt u bij het ontwerpen van robuuste retry-logica.
Het contextvenster ondersteunt in totaal 100.000 tokens. Dit omvat zowel de invoerprompt als de gegenereerde completion. Plan je tokengebruik dienovereenkomstig om truncatie of fouten te vermijden.
