Snelstart: integreer in enkele minuten

1. Installeer je SDK

Installeer eerst de officiële bibliotheek voor je taal. De meeste ontwikkelaars geven de voorkeur aan het standaardpakket omdat dit overeenkomt met de interface die ze al kennen. Voer pip install openai voor Python of npm install openai voor Node.js. U heeft slechts één SDK nodig om alle verzoeken af te handelen.

2. Stel je basis-URL in

Configureer je client om naar ons specifieke eindpunt te wijzen. Je moet de standaard base-URL overschrijven om het verkeer correct te routeren. Gebruik https://api.unsencoredai.com/v1 als je basis-URL. Geef je API-sleutel door in de Authorization header. Deze opstelling werkt met elke standaard OpenAI-compatible client.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

3. Stuur je eerste verzoek

Stuur een standaard chat-completion verzoek om tekst te genereren. De model-ID is uncensored. Je kunt system prompts versturen om het gedrag te sturen. De API retourneert een directe tekstantwoord. Gebruik het onderstaande curl-commando om de connectiviteit onmiddellijk te testen. Controleer je respons op de choices array.

Copycurl https://api.unsencoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the version number"}]
  }'

4. Verwerk streaming-antwoorden

Schakel streaming in voor lagere latentie en real-time uitvoer. Stel stream: true in je verzoek. De API stuurt chunks via Server-Sent Events. Je kunt elk token verwerken zodra het aankomt. Dit is ideaal voor chatinterfaces of roleplay-scenario's. De laatste chunk bevat gebruikstatistieken.

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)

5. Parameters configureren

Aanpassen temperature, top_p, en stop sequenties. Deze controls beïnvloeden creativiteit en uitvoerlengte. Je kunt ook response_format voor JSON-modus. Het contextvenster ondersteunt 100,000 tokens in totaal. Max output is 16,000 tokens per verzoek. Stel deze instellingen af op uw specifieke use case.

6. Limieten, fouten en context

Handel fouten soepel af met standaard HTTP-statuscodes. Een 401-fout betekent dat je API-sleutel ongeldig is. Een 402-fout geeft aan dat er onvoldoende vooruitbetaalde credit is. Een 429-fout signaleert dat je de limiet van 300 verzoeken per minuut hebt bereikt. Je contextvenster is 100,000 tokens. Verzoeken boven de 8 MB kunnen mislukken. Er worden geen refunds uitgegeven voor credit, maar fouten zijn gratis.