NL ▾
Uncensored Chatbot APIDirecte API-toegang tot één ongedecensureerd LLMAPI-sleutel aanvragen

Uncensored Chatbot APISafety

Chatbot-API-integratie: koppel een chat-endpoint aan je app

Een chatbot-API-integratie heeft één regel die je niet kunt overslaan: de browser houdt nooit de API-sleutel. Plaats een kleine backend-proxy ertussen, stream antwoorden via die proxy en de rest is gewone webontwikkeling.

Bijgewerkt

Glazen leiding die een browserblok en een serverblok verbindt via een afgesloten poort, die een backend-chatproxy toont

Belangrijkste punten

  • De browser communiceert met je server; je server communiceert met de chat-API met de sleutel.
  • Stream met server-sent events zodat antwoorden woord voor woord verschijnen.
  • Beperk de geschiedenis, stel per-gebruiker limieten in en verwerk 429-responses met een korte wachttijd.
  • Het endpoint is OpenAI-compatible, dus de officiële SDK werkt na een wijziging van de base URL.

Het patroon op één afbeelding

Elke veilige chatbot api-integratie ziet er van bovenaf hetzelfde uit. Een pagina in de browser stuurt het bericht van de gebruiker naar je eigen endpoint. Je server voegt de system prompt toe, knipt de geschiedenis af, koppelt de API-sleutel en stuurt het verzoek door. Het antwoord stroomt op dezelfde manier terug.

Browser  --POST /api/chat-->  Your server  --POST /v1/chat/completions-->  Chat API
Browser  <--SSE stream------  Your server  <--SSE stream-----------------  Chat API

De proxy bestaat om vier redenen: hij verbergt de sleutel, stelt je in te controleren wie er belt, stelt je in de kosten per gebruiker te beperken en geeft je één plek om de modelinstellingen later aan te passen. Een sleutel in frontend-JavaScript is publiek zodra de pagina laadt, en iemand anders verbruikt je prepaid tegoed.

De API volgt het OpenAI-formaat. De base URL is https://api.uncensoredchatbotapi.com/v1, het model is uncensored, en auth is Authorization: Bearer YOUR_KEY. Haal een sleutel op de sleutelpagina.

Stap 1: de serverproxy

Deze Express-server accepteert een gesprek, voegt een systeemprompt toe, roept de API aan met streaming en stuurt de tekst door. Installeer de afhankelijkheden met npm i express openai en stel CHAT_API_KEY in de omgeving in.

import express from "express";
import OpenAI from "openai";

const app = express();
app.use(express.json({ limit: "200kb" }));
app.use(express.static("public"));

const client = new OpenAI({
  baseURL: "https://api.uncensoredchatbotapi.com/v1",
  apiKey: process.env.CHAT_API_KEY,
});

const SYSTEM = "You are a helpful companion for adults. Keep replies under 150 words.";

app.post("/api/chat", async (req, res) => {
  const incoming = Array.isArray(req.body.messages) ? req.body.messages : [];
  const clean = incoming
    .filter((m) => ["user", "assistant"].includes(m.role) && typeof m.content === "string")
    .slice(-20)
    .map((m) => ({ role: m.role, content: m.content.slice(0, 4000) }));

  res.writeHead(200, { "Content-Type": "text/event-stream", "Cache-Control": "no-cache" });
  try {
    const stream = await client.chat.completions.create({
      model: "uncensored",
      messages: [{ role: "system", content: SYSTEM }, ...clean],
      stream: true,
    });
    for await (const part of stream) {
      const t = part.choices[0]?.delta?.content;
      if (t) res.write(`data: ${JSON.stringify(t)}\n\n`);
    }
    res.write("data: [DONE]\n\n");
  } catch (e) {
    res.write(`event: error\ndata: ${JSON.stringify(e.status === 429 ? "busy" : "failed")}\n\n`);
  }
  res.end();
});

app.listen(3000);

Let op de filtering. De client kan alles sturen, dus de server bewaart alleen user en assistant berichten, knipt elk bericht af en negeert elk system bericht dat de browser probeert in te brengen. De systeemprompt komt altijd uit je code.

Stap 2: de browserkant

De browser leest de stream met fetch en voegt tekst toe terwijl deze aankomt. Er is geen bibliotheek nodig.

const messages = [];

async function send(text, out) {
  messages.push({ role: "user", content: text });
  const res = await fetch("/api/chat", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ messages }),
  });

  const reader = res.body.getReader();
  const dec = new TextDecoder();
  let reply = "", buf = "";

  while (true) {
    const { done, value } = await reader.read();
    if (done) break;
    buf += dec.decode(value, { stream: true });
    const events = buf.split("\n\n");
    buf = events.pop();
    for (const ev of events) {
      if (ev === "data: [DONE]") break;
      if (ev.startsWith("data: ")) {
        reply += JSON.parse(ev.slice(6));
        out.textContent = reply;
      }
    }
  }
  messages.push({ role: "assistant", content: reply });
}

De buffer is belangrijk. Netwerkblokken komen niet overeen met gebeurtenisgrenzen, dus je splitst op de lege regel en bewaart de onvolledige staart voor de volgende leesbeurt. Voor een uitleg van de pagina zelf, zie de webchat-tutorial, en voor het grotere plaatje van het toevoegen van een bot aan een website, hoe je een chatbot in een website implementeert.

Limieten, fouten en retries

Een volledige sleutel staat 8 gelijktijdige verzoeken en 300 per minuut toe. Een proefsleutel staat 2 en 60 toe. Een gestreamd verzoek bezet zijn slot tot de stream eindigt, dus met 8 slots kun je maximaal 8 live antwoorden tegelijk bedienen. Als je site meer gelijktijdige gebruikers heeft dan dat, zet verzoeken in wachtrij in je server en antwoord "een moment" in plaats van falen.

  • 429 met concurrency: te veel verzoeken zijn actief. Wachtrij en probeer opnieuw.
  • 429 met rate_limited: te veel verzoeken per minuut. Vertraag.
  • 429 met een Retry-After: 5 header: tijdelijke overbelasting. Wacht 5 seconden en probeer het opnieuw.
  • 401: verkeerde of ontbrekende sleutel.
  • Body boven 8 MB: afgewezen, dus knip wat je verstuurt.

Voeg een kleine in-memory teller toe zodat je eigen server nooit meer dan 8 upstream-streams opent:

let active = 0;
const MAX = 8;

app.use("/api/chat", (req, res, next) => {
  if (active >= MAX) return res.status(503).json({ error: "busy" });
  active++;
  res.on("close", () => { active--; });
  next();
});

Registreer deze middleware voordat de chatroute wordt aangeroepen. Het close-gebeurtenis treedt in wanneer de respons eindigt of de gebruiker vertrekt, dus de teller lekt niet.

Beheer de kosten van elk gesprek

De prijs is $0,15 per 1M input tokens en $0,50 per 1M output tokens. Omdat elke beurt de geschiedenis opnieuw verzendt, is de limiet op de geschiedenis je grootste hefboom. Met de laatste 20 berichten van ongeveer 60 tokens elk plus een 100-token systeemprompt, draagt een verzoek ongeveer 1.300 input tokens. Een 150-token antwoord voegt output toe.

Kosten per beurt: 1.300 / 1.000.000 x $0,15 = $0,000195, plus 150 / 1.000.000 x $0,50 = $0,000075, dus $0,00027. Een 30-beurt sessie van die grootte kost maximaal $0,0081, omdat eerdere beurten korter zijn. Per-gebruiker daglimieten, bijvoorbeeld 100 berichten, beperken je ergste geval tot 100 x $0,00027 = $0,027 per gebruiker per dag. Voor meer over het prijzen van een site bot, lees de pagina op kosten van chatbot op website, en gebruik de documentatie voor parameters zoals max_tokens.

Wie roept je proxy aan

De proxy beschermt de sleutel, maar het wordt ook een gratis chat-endpoint voor iedereen die de URL vindt. Beslis wie het mag gebruiken voordat je het uitbrengt.

Voor een publieke site is een ondertekend sessiecookie ingesteld bij het inloggen het gebruikelijke antwoord. Controleer dit bovenaan de route en retourneer 401 wanneer het ontbreekt. Voor een snelle prototype is een per-IP limiet met een pakket zoals express-rate-limit beter dan niets, hoewel gedeelde netwerken IP-limieten grof maken. Wat je ook kiest, tel berichten per gebruiker, niet per verbinding, en bewaar de telling waar een herstart deze niet kan resetten.

Bewaar gespreksgeschiedenis op de server zodra de app groeit. De hele geschiedenis vanuit de browser op elke beurt versturen is makkelijk te bouwen, maar gebruikers kunnen het bewerken. Sla berichten op in een database onder een conversation id, laad de laatste 20 op elk verzoek, en voeg het antwoord toe nadat de stream eindigt. Dit stelt ook een gebruiker in staat het tabblad te sluiten en terug te keren naar dezelfde chat.

Voordat je lanceert

Een korte checklist houdt de lanceringdag rustig.

  1. De sleutel leeft alleen in een omgevingsvariabele op de server, en de repository bevat deze niet.
  2. De server negeert elk systeembericht van de client.
  3. Elke gebruiker heeft een berichtlimiet per dag en een berichtlengte limiet.
  4. Fouten tonen een vriendelijk bericht en loggen nooit interne details.
  5. Je logt request-IDs van de X-Request-Id header en tokenaantallen, niet de volledige tekst.
  6. Je houdt X-Balance-USD in de gaten en krijgt een waarschuwing als het tegoed laag wordt.
  7. Je voorwaarden stellen dat het publiek alleen volwassenen is, en de bot produceert nooit seksuele inhoud met minderjarigen.

Het laatste punt wordt gedeeld met de richtlijnen voor veiligheid van chatbots voor volwassenen. Het model achter deze API is afgestemd om te antwoorden zonder inhoudsweigeringen voor wettelijk volwassen gebruik, wat je eigen leeftijdscontrole en moderatieregels belangrijker maakt, niet minder. Top-ups hier zijn alleen crypto (USDT op TRC20 of USDC op Base), van $20 tot $500, en nieuwe gebruikers kunnen eerst een proefversie van $0,50 claimen.

Vragen en antwoorden

Waarom kan ik de API niet rechtstreeks aanroepen vanuit JavaScript in de browser?

Omdat de sleutel dan zichtbaar is voor iedereen die het netwerktabblad opent. Een backend-proxy houdt de sleutel op je server en stelt je in staat limieten per gebruiker in te stellen.

Ondersteunt de API streaming?

Ja. Stel stream in op true en de API stuurt server-sent events, met gebruiksstatistieken aan het einde. Je proxy kan deze events doorsturen naar de browser.

Welke SDK moet ik gebruiken?

Elke OpenAI SDK of HTTP-client werkt. Pas de base URL aan naar https://api.uncensoredchatbotapi.com/v1, gebruik je sleutel en stel het model in op uncensored.

Wat gebeurt er als er te veel gebruikers tegelijk chatten?

Een volledige sleutel staat 8 gelijktijdige verzoeken toe. Daarna retourneert de API 429 met de code concurrency, dus zet extra verzoeken in de wachtrij op je server en probeer het kort daarna opnieuw.

Je sleutel is nog maar één formulier verwijderd

Maak een account aan, kopieer de sleutel, pas de base URL aan. Dat is de hele setup.

API-sleutel ophalenDocumentatie lezen