Integratiegids voor Uncensored API

Authenticatie & basis-URL

Wijs je OpenAI-compatibele SDK eerst naar het toegewijde eindpunt. Onze infrastructuur maakt gebruik van een enkele basis-URL voor alle verzoeken, waardoor je alleen communiceert met het uncensored-model zonder vendor lock-in. Je moet je API-sleutel opnemen in de Authorization header voor elke call. Deze sleutel wordt direct gegenereerd wanneer je je aanmeldt via Google of e-mail. Er zijn geen maandelijkse kosten om toegang te behouden, en de sleutel blijft geldig totdat je vooruitbetaalde tegoed op is. Fouten tijdens authenticatie, zoals een ongeldige sleutel, retourneren een 401-statuscode. Weigeringen voor wettelijke volwassen inhoud zijn gratis, maar je betaalt alleen voor daadwerkelijk tokengebruik.

Copycurl https://api.unsecureapikeys.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the three main dependencies for this python script"}]
  }'

Chat Completions-endpoint

Stuur tekstgegevens naar de POST /v1/chat/completions endpoint om gegenereerde antwoorden te ontvangen. Dit is de primaire interface voor je integraties, met ondersteuning voor een contextvenster van 100.000 tokens voor zowel prompt als voltooiing. De model-ID die je in je payload moet opgeven, is altijd uncensored. Je hoeft je geen zorgen te maken over complexe modelrouting of versiebeheer, aangezien we één open-weight model leveren dat is afgestemd op ongefilterde output. Als je de limiet van 8 MB voor de request body overschrijdt, retourneert de API een fout. Je kunt ook beschikbare modellen controleren via GET /v1/models naar verbinding te verifiëren voordat je zwaar werk levert.

Streaming-responsen

Activeer realtime tokengeneratie door stream: true in je request payload. De API retourneert Server-Sent Events (SSE) voor latentiearme weergave in je applicaties. Tokenverbruiksstatistieken verschijnen in de laatste chunk van de stream, waardoor je kosten nauwkeurig kunt bijhouden. Deze methode is ideaal voor chatbots of interactieve interfaces waar gebruikers directe feedback verwachten. Let op dat de maximale uitvoer per request tot het volledige venster van 100,000 tokens bedraagt; max_tokens is optioneel. Streaming werkt naadloos met standaard OpenAI SDK's wanneer de base_url correct is bijgewerkt.

Copyfrom openai import OpenAI

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

Functiedaanroep & JSON-modus

Integreer gestructureerde data-uitvoer met JSON-modus of function calling-mogelijkheden. Stel response_format naar {"type": "json_object"} om consistente JSON-uitvoer af te dwingen voor uw parsers. U kunt ook tools definiëren en specificeren tool_choice voor complexe agent-workflows. Het uncensored-model ondersteunt deze functies zonder de gebruijke strenge guardrails die vaak schemas voor functies breken bij andere aanbieders. Dit maakt het betrouwbaar voor geautomatiseerde pipelines die precisie gegevensextractie vereisen. Zorg ervoor dat uw tooldefinities geldig zijn om parserfouten aan de clientkant te voorkomen.

Copyimport OpenAI from "openai";

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

Parameters & Limieten

Reguleer het generatiegedrag met standaardparameters zoals temperature, top_p, stop, en seed. Door deze aan te passen, kun je de balans tussen creativiteit en determinisme in je outputs fijnafstemmen. Je bent beperkt tot 300 verzoeken per minuut per sleutel, met een gelijktijdige concurrency van 8 gelijktijdige verzoeken. Er is slechts één actieve sleutel toegestaan per account; het genereren van een nieuwe vervangt de oude. Het prepaid creditmodel betekent dat je $0.15 betaalt per 1M input tokens en $0.50 per 1M output tokens. Fouten verbruiken geen tegoed, zodat je alleen betaalt voor succesvolle voltooiingen.

Fouthantering

Verwerk veelvoorkomende API-responsies soepel om de stabiliteit van de applicatie te waarborgen. Een 401-fout geeft een ongeldige of verlopen API-sleutel aan. Een 402-fout betekent dat je vooruitbetaalde saldo onvoldoende is, wat een crypto-opwaardering via USDT of USDC vereist. Snelheidslimieten triggeren een 429-respons als je meer dan 300 requests per minuut overschrijdt. De API retourneert geen embeddings of afbeeldingsdata, dus het aanvragen van die formaten kan fouten veroorzaken. Controleer altijd de statuscode voordat je de JSON-body parseert. Contextvensterlimieten zijn strikt, dus bewaak het tokenaantal om inkorting bij lange gesprekken te voorkomen.

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)