Snelstart: integreer de Uncensored API

Vereisten: SDK en omgevingconfiguratie

Installeer de officiële SDK voor uw taal. We ondersteunen elke openai compatibele client. Onze dienst fungeert als een drop-in vervanging voor standaard OpenAI-integraties.

Stel je omgevingsvariabele onmiddellijk in. Dit voorkomt dat je referenties hardcode in je bronbestanden. Je API-sleutel identificeert je account en houdt gebruik bij.

Gebruik de standaardbibliotheek. De meeste ontwikkelaars hebben deze al geïnstalleerd. Zo niet, voeg het pakket dan toe aan je afhankelijkheden.

Authenticatie: De API-sleutel instellen

Voer uw sleutel via de Authorization header. We vereisen een Bearer-token voor elke request. Deze methode is standaard voor alle OpenAI-compatible endpoints.

Genereer je sleutel vanuit het dashboard. Je ontvangt één actieve sleutel per account. Het vervangen ervan maakt de vorige sleutel direct ongeldig.

Houd je sleutel veilig. Stel deze niet bloot in clientcode. Ons eindpunt valideert referenties voordat tokens worden verwerkt.

Eindpunt: POST /v1/chat/completions

Stuur je prompt naar het chat-eindpunt. Gebruik de model veld ingesteld op uncensored. Dit zorgt ervoor dat het verzoek naar ons specifieke model wordt gerouteerd.

Streaming-responsen via SSE

Activeer streaming door stream: true. Je ontvangt chunks terwijl ze worden gegenereerd. Dit vermindert de waargenomen latentie voor lange uitvoer.

Parseer het Server-Sent Events-formaat. Elk blok bevat gedeeltelijke tekst. Aggregateer deze blokken om de volledige respons te reconstrueren.

Monitor tokengebruik in het laatste chunk. Het laatste evenement bevat de volledige gebruiksstatistieken. Dit helpt je kosten nauwkeurig te volgen.

Function Calling en toolgebruik

Definieer tools in de request body. Het model retourneert gestructureerde argumenten. Parse deze argumenten in je applicatielogica.

Ondersteunt standaard tooldefinities. Gebruik tool_choice om specifiek gedrag af te dwingen. Dit werkt met elke OpenAI-compatible SDK.

Valideer het uitvoerformaat. Zorg ervoor dat je code ontbrekende argumenten soepel afhandelt. Het model kan velden weglaten als ze niet vereist zijn.

JSON-modus en gestructureerde uitvoer

Instellen response_format naar json_object. Het model retourneert strikt geformatteerde JSON. Dit elimineert parsing-fouten voor gestructureerde gegevens.

Definieer je schema duidelijk. Het model volgt je instructies nauwkeurig. Gebruik dit voor gegevensextractie of configuratiegeneratie.

Afhandelen van JSON-parsefouten. Ongeldige structuren komen nog steeds af en toe voor. Implementeer fallback-logica voor robuuste applicaties.

Fouthantering en Rate Limits

Afhandelen van HTTP-statuscodes op de juiste manier. Een 401 fout betekent dat je sleutel ongeldig is. Een 402 fout wijst op onvoldoende tegoed. Een 429 fout signaleert limitering van verzoeken.

Respecteer de limiet van 300 verzoeken per minuut. Je kunt 8 gelijktijdige verzoeken sturen. Het overschrijden van deze limieten retourneert een 429-fout. Wacht voordat je opnieuw probeert.

Uw contextvenster is 100.000 tokens. Dit omvat zowel input als output. Beheer uw tokenbudget zorgvuldig. Max output is 16.000 tokens per verzoek. Fouten verbruiken geen tegoed.

cURL

Copycurl https://api.alternativeapiopenai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the primary functions in this module"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Streaming

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)