NL ▾

unfilteredaiapi.comhttps://api.unfilteredaiapi.com/v1

Unfiltered AI

Ruwe, ongekansureerde LLM API voor ontwikkelaars.

Unfiltered AIAPI-sleutel aanvragen

Node JS AI API: Streaming, Tools en Fouten in Express

Deze node js ai api-tutorial neemt je mee van een lege map naar een Express-route die chatantwoorden streamt, een tool aanroept en rate-limit-fouten verwerkt. Je wijzigt alleen de base URL en sleutel in het officiële OpenAI-pakket en stuurt vervolgens model uncensored.

Hexagonische tandwiel verbonden met een serverrek dat lichtdeeltjes streamt naar een browservenster

Belangrijkste punten

  • Installeer het openai-pakket en stel baseURL in op https://api.unfilteredaiapi.com/v1.
  • Stream met stream: true en stuur chunks door naar de browser als server-sent events.
  • Tool calls komen aan als tool_calls; retourneer resultaten met role tool.
  • 429 betekent rate_limited, concurrency of tijdelijke overbelasting; probeer het opnieuw na de Retry-After-vertraging.

Instellen: installeer en stuur het eerste verzoek

Je hebt Node 18 of nieuwer nodig. Maak een project aan, installeer de SDK en Express en schakel over op ES-modules.

mkdir ai-node && cd ai-node
npm init -y
npm pkg set type=module
npm install openai express
# base URL: https://api.unfilteredaiapi.com/v1   model: uncensored
export AI_API_KEY="YOUR_KEY"

Haal een sleutel op van de API-sleutelpagina. Nieuwe accounts kunnen met één klik $0,50 aan gratis proeftegoed claimen, geldig voor 7 dagen. Maak vervolgens client.js aan:

import OpenAI from "openai";

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

const res = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Give me three names for a tavern keeper." }],
});
console.log(res.choices[0].message.content);

Voer het uit met node client.js. Elke snippet hieronder definieert de client opnieuw, zodat deze op zichzelf kan draaien. Dat is de hele migratie als je het OpenAI-pakket al gebruikt: een andere baseURL, je sleutel en de model-ID. De service is OpenAI-compatible en alleen tekst, met een contextvenster van 100.000 tokens. Zie de documentatie voor alle ondersteunde methoden.

Stream het antwoord

Streaming stuurt tokens zodra ze worden gegenereerd, zodat gebruikers tekst direct zien. Stel stream: true in en iteratie over de chunks:

import OpenAI from "openai";

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

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Describe a rainy harbor town." }],
  stream: true,
  stream_options: { include_usage: true },
});

for await (const chunk of stream) {
  const delta = chunk.choices[0]?.delta?.content;
  if (delta) process.stdout.write(delta);
  if (chunk.usage) console.log("\nusage:", chunk.usage);
}

Gebruik komt in het laatste chunk, waardoor je echte tokenaantallen per verzoek kunt loggen. Houd één feit in gedachten: een gestreamd verzoek bezet zijn concurrency-slot tot de stream eindigt. Als de client de verbinding verliest, onderbreek dan de upstream-call zodat het slot snel vrijkomt.

Een Express-route die naar de browser streamt

Hier is een kleine server met een POST /chat-route. Het stuurt de stream door als server-sent events en annuleert de upstream-request wanneer de browser de verbinding sluit.

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

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

const app = express();
app.use(express.json({ limit: "1mb" }));

app.post("/chat", async (req, res) => {
  const { messages } = req.body;
  if (Array.isArray(messages) === false) return res.status(400).json({ error: "messages required" });

  res.set({
    "Content-Type": "text/event-stream",
    "Cache-Control": "no-cache",
    Connection: "keep-alive",
  });

  const controller = new AbortController();
  req.on("close", () => controller.abort());

  try {
    const stream = await client.chat.completions.create(
      { model: "uncensored", messages, stream: true },
      { signal: controller.signal }
    );
    for await (const chunk of stream) {
      const delta = chunk.choices[0]?.delta?.content;
      if (delta) res.write("data: " + JSON.stringify({ delta }) + "\n\n");
    }
    res.write("data: [DONE]\n\n");
  } catch (err) {
    res.write("data: " + JSON.stringify({ error: err.status || 500 }) + "\n\n");
  } finally {
    res.end();
  }
});

app.listen(3000, () => console.log("listening on 3000"));

Plaats de sleutel nooit in browsercode. De bovenstaande route houdt deze op de server, waar hij thuishoort. Hetzelfde patroon wordt getoond in Python in het FastAPI-chatbot-backend-artikel.

Een tool aanroepen

Tool calling volgt het OpenAI-formaat: je beschrijft functies in tools, het model antwoordt met tool_calls, je voert de functie uit en stuurt het resultaat terug als een bericht met role: "tool".

import OpenAI from "openai";

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

const tools = [{
  type: "function",
  function: {
    name: "roll_dice",
    description: "Roll a die with the given number of sides",
    parameters: {
      type: "object",
      properties: { sides: { type: "integer" } },
      required: ["sides"],
    },
  },
}];

const messages = [{ role: "user", content: "Roll a d20 for my attack." }];
const first = await client.chat.completions.create({
  model: "uncensored", messages, tools, tool_choice: "auto",
});

const msg = first.choices[0].message;
if (msg.tool_calls) {
  messages.push(msg);
  for (const call of msg.tool_calls) {
    const { sides } = JSON.parse(call.function.arguments);
    const result = 1 + Math.floor(Math.random() * sides);
    messages.push({ role: "tool", tool_call_id: call.id, content: String(result) });
  }
  const second = await client.chat.completions.create({ model: "uncensored", messages, tools });
  console.log(second.choices[0].message.content);
}

Parse arguments altijd in een try-block in echte code, omdat modellen af en toe ongeldige JSON kunnen retourneren. Voor gestructureerde output zonder tools stel je response_format: { type: "json_object" } in en vermeld je JSON in je prompt. Game-scènes die dobbelsteen- of inventarisfuncties aanroepen, worden behandeld in game-NPC's en interactieve fictie bouwen.

Fouten en rate limits afhandelen

De API retourneert HTTP 429 in drie situaties. Foutcode rate_limited betekent te veel verzoeken per minuut: 300 voor een volledige sleutel, 60 voor een proefsleutel. Code concurrency betekent te veel tegelijk: 8 voor een volledige sleutel, 2 voor een proefsleutel. Bij tijdelijke overbelasting krijg je ook 429 met een Retry-After: 5-header. De SDK exposeert de status op de gegooide fout, dus een kleine wrapper behandelt alle drie:

import OpenAI from "openai";

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

const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

export async function chatWithRetry(params, tries = 4) {
  for (let i = 0; i < tries; i++) {
    try {
      return await client.chat.completions.create({ model: "uncensored", ...params });
    } catch (err) {
      if (err.status === 429 && i < tries - 1) {
        const wait = Number(err.headers?.["retry-after"]) || 2 ** i;
        await sleep(wait * 1000);
        continue;
      }
      throw err;
    }
  }
}

De wrapper wacht op de vertraging die de server vraagt en valt terug op exponentiële back-off. Merk op dat het OpenAI-pakket ook sommige fouten zelf opnieuw probeert; stel maxRetries in op de client als je dit wilt regelen. Andere statussen, zoals 401 voor een foute sleutel, moeten niet opnieuw worden geprobeerd. Een diepere blik op limieten vind je in de FAQ.

De route uitvoeren en testen

Start de server met node server.js en test deze vanuit een tweede terminal. De -N-vlag zet buffering van curl uit, zodat je ziet hoe events één voor één aankomen:

# the server calls https://api.unfilteredaiapi.com/v1 with model uncensored
curl -N http://localhost:3000/chat   -H "Content-Type: application/json"   -d '{"messages":[{"role":"user","content":"Write a two-line riddle."}]}'

In de browser lees je de stream met fetch en een reader, of met een kleine SSE-helpersbibliotheek. Omdat de route een POST is, past het native EventSource-object niet, dus gebruik fetch en decodeer de chunks zelf.

Productiegebruik

  • Houd de sleutel in een omgevingsvariabele of een geheime opslag, nooit in de repository.
  • Beperk de request body. De API accepteert tot 8 MB, maar je eigen route moet veel minder accepteren.
  • Beperk de geschiedenis die je stuurt. Knip oude beurten af voordat ze je geld kosten of het 100.000-token contextvenster vullen.
  • Wacht extra werk in een wachtrij of wijs het af wanneer je al 8 streams open hebt, in plaats van dat de API 429 aan je gebruikers terugstuurt.
  • Log de X-Request-Id-responseheader, zodat support een enkel verzoek kan traceren.

Je saldo en kosten controleren

Elk antwoord bevat een X-Balance-USD-header, en GET /v1/balance retourneert het saldo direct. Prijzen zijn $0,15 per 1M input tokens en $0,50 per 1M output tokens, afgeschreven van prepaid tegoed, en mislukte of geweigerde verzoeken zijn gratis. Een chatbeurt van 800 input en 250 output tokens kost $0,000245, dus 10.000 beurten kosten $2,45. Log usage van elk antwoord en je kunt je factuur binnen een paar cent voorspellen. De prijzenpagina geeft top-ups van $20 tot $500 weer.

Vragen en antwoorden

Welk npm-pakket moet ik gebruiken?

Het officiële openai-pakket werkt. Stel baseURL in op https://api.unfilteredaiapi.com/v1, geef je sleutel op en gebruik de model-ID uncensored.

Kan ik antwoorden streamen vanuit Node?

Ja. Geef stream: true door en iteratie met for await. Voeg stream_options met include_usage toe om tokenaantallen in het laatste chunk te krijgen.

Ondersteunt de API function calling?

Ja. Stuur tools en tool_choice, lees tool_calls uit het antwoord en retourneer resultaten als berichten met role tool.

Wat moet mijn server doen bij HTTP 429?

Wacht op de Retry-After-waarde als die aanwezig is, anders back-off exponentieel en probeer het een paar keer opnieuw. Verminder gelijktijdige verzoeken als de foutcode concurrency is.

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