Bijgewerkt
No Filter AI Roleplay-app: bouw er een met een API
Een AI-vriendin API biedt een speciale interface voor chatapplicaties die romantische of gezelschap-achtige interacties simuleren met grote taalmodellen. Deze gids vergelijkt technische benaderingen, met focus op ongecensureerde modellen die rolspelcontext verwerken zonder standaard inhoudsweigeringen.

De architectuur in één beeld
De browser stuurt de boodschap van de gebruiker naar je server. Je server voegt de persona en de recente geschiedenis toe, roept het model aan met stream: true en stuurt elk brokje door. Er is niets anders nodig.
- Browser: een tekstvak en een div die groeit naarmate tokens aankomen.
- Jouw server: houdt de API-sleutel bij, maakt de berichtenlijst en handhaaft je eigen limieten per gebruiker.
- Model API:
POST /v1/chat/completionsophttps://api.nofilterai.top/v1met modeluncensored. - Opslag: een tabel of bestand met berichten per gesprek. SQLite is genoeg om te beginnen.
Het model is één open-weight model, getuned om te antwoorden zonder inhoudelijke weigeringen voor wettelijk volwassen gebruik. Het is alleen tekst. Als je karakterart of stem wilt, voeg je zelf een andere service toe.
Ontwerp de system prompt
Voor roleplay doet de system prompt het meeste werk. Split het in drie korte blokken zodat je elk blok onafhankelijk kunt wisselen: de wereld, het personage en de regels van het formaat.
{
"world": "A rain-soaked port city in 1920s Europe, run by rival smuggling families.",
"character": "Ilse, a sharp-tongued ferry captain who trusts nobody but her brother.",
"format": "Write in third person past tense. 2 to 4 short paragraphs. Never write the user's actions or lines."
}
Voeg ze samen tot één systeembericht op het moment van het verzoek. Ze gescheiden houden stelt gebruikers in staat een wereld en een personage onafhankelijk te kiezen, wat het meeste is wat een roleplay-app nodig heeft. Omdat volwassen fictie is toegestaan voor wettelijk volwassen gebruik, vermeld dit één keer in je eigen gebruiksvoorwaarden en voeg een leeftijdsgrens toe. Het enige dat de API niet produceert, is seksuele inhoud met minderjarigen, en dat moet je app ook niet proberen.
Het streaming-backend
Deze Express-route accepteert een gesprek-ID en een bericht, laadt de geschiedenis en pipe de stream naar de browser als server-sent events. Het maakt gebruik van de officiële openai package.
import express from "express";
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.nofilterai.top/v1",
apiKey: process.env.API_KEY,
});
const app = express();
app.use(express.json());
const store = new Map(); // conversationId -> messages
app.post("/chat", async (req, res) => {
const { id, text, persona } = req.body;
const history = store.get(id) ?? [];
history.push({ role: "user", content: text });
res.setHeader("Content-Type", "text/event-stream");
res.setHeader("Cache-Control", "no-cache");
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "system", content: persona }, ...trim(history)],
stream: true,
temperature: 0.9,
});
let reply = "";
for await (const chunk of stream) {
const piece = chunk.choices[0]?.delta?.content ?? "";
if (piece) {
reply += piece;
res.write("data: " + JSON.stringify(piece) + "\n\n");
}
}
history.push({ role: "assistant", content: reply });
store.set(id, history);
res.write("data: [DONE]\n\n");
res.end();
});
app.listen(3000);
Het laatste chunk van een stream bevat gebruiksinformatie, die je kunt loggen om te zien wat elk gesprek kost. In productie vervang je de Map door een database en voeg je foutafhandeling toe rond de aanroep.
Geschiedenis opschonen binnen het 100k-venster
Het contextvenster is 100.000 tokens voor prompt plus voltooiing. Rollspelsessies groeien langzaam, maar ze groeien. Een opschoonfunctie die op grootte werkt voorkomt verrassingen. Een ruwe schatting van 4 tekens per token is goed genoeg voor budgettering.
function trim(history, maxChars = 120000) {
let total = 0;
const kept = [];
for (let i = history.length - 1; i >= 0; i--) {
total += history[i].content.length;
if (total > maxChars) break;
kept.unshift(history[i]);
}
return kept;
}
120.000 tekens is ongeveer 30.000 tokens, ver onder de limiet, en houdt elke aanroep goedkoop. Verhoog het alleen als je verhaal lange herinnering nodig heeft. Onthoud de kostenregel: elke beurt verstuurt de bewaarde geschiedenis opnieuw als input tegen $0,15 per 1M tokens, dus een prompt van 30.000 tokens kost 30.000 / 1.000.000 x $0,15 = $0,0045 per beurt vóór het antwoord.
De browserclient
De pagina leest de SSE-stream met fetch en voegt tekst toe naarmate deze aankomt. Omdat het verzoek een POST is, past EventSource niet, dus parse de stream handmatig.
async function send(text) {
const out = document.getElementById("reply");
out.textContent = "";
const r = await fetch("/chat", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ id: "demo", text, persona: PERSONA }),
});
const reader = r.body.getReader();
const dec = new TextDecoder();
let buf = "";
while (true) {
const { value, done } = await reader.read();
if (done) break;
buf += dec.decode(value, { stream: true });
const parts = buf.split("\n\n");
buf = parts.pop();
for (const p of parts) {
if (p === "data: [DONE]") break;
if (p.startsWith("data: ")) {
out.textContent += JSON.parse(p.slice(6));
}
}
}
}Functies die het als een app laten voelen
- Regenereren en bewerken. Houd bericht-ID's aan. Regenereren betekent het laatste assistentbericht verwijderen en opnieuw een API-aanroep doen met dezelfde geschiedenis. Bewerken betekent een opgeslagen bericht herschrijven vóór de volgende aanroep.
- Instellingen per karakter. Sla
temperature,top_pen straffingen op bij elk karakter. Rustigere karakters zoals 0,7, chaotische zoals 1,0. Geefseeddoor als je reproduceerbare testruns wilt. - Kostentoon. Lees de
X-Balance-USDresponse header of roepGET /v1/balanceaan en laat de gebruiker zien hoeveel tegoed er nog over is. Als je toegang doorverkoopt aan je eigen gebruikers, bespaart dit je veel supportvragen. - Veiligheidsrails die jij beheert. Voeg een alleen-volwassen-gate toe, een rapporteer-knop en een regel die elk verzoek dat minderjarigen betreft blokkeert voordat het de API bereikt. Het platform handhaaft die limiet ook, maar jouw app moet dat ook doen.
Limieten, fouten en budgetten
Een volledige sleutel staat 8 gelijktijdige verzoeken en 300 verzoeken per minuut toe. Een gestreamd verzoek houdt een concurrency-slot vast tot de stream eindigt, dus een roleplay-app met 20 actieve gebruikers raakt de cap tijdens drukke minuten. De API antwoordt HTTP 429 met de code concurrency of rate_limited, en bij tijdelijke overbelasting voegt het Retry-After: 5 toe. Zet verzoeken in een wachtrij op je server en probeer het opnieuw na die vertraging.
Mislukte of geweigerde verzoeken worden niet in rekening gebracht, dus herhaalde pogingen kosten je niets. Voor budgettering kost een typische beurt van 3.000 invoertokens en 300 uitvoertokens $0,00045 + $0,00015 = $0,0006. Tegoed wordt vooraf betaald vanaf $20 en verloopt nooit. Deze site accepteert crypto, USDT op TRC20 of USDC op Base; de prijzenpagina vermeldt de bonussen vanaf $50.
Waar je nu naartoe kunt
Krijg een sleutel en test met het gratis proeftegoed: de API-sleutelpagina biedt $0,50 tegoed na het aanmaken van een account, geldig voor 7 dagen, zonder betalingsgegevens. De proefsleutel staat 2 gelijktijdige verzoeken toe, genoeg voor een prototype voor één gebruiker. De docs vermelden elke parameter, inclusief function calling als je dobbelsteenrollen of inventaris wilt afhandelen als function calls.
Voor een companion-achtige variant met één persistent personage, zie het AI companion API artikel. Voor een chatbot binnen een server, lees de Discord-botgids.
Meer handleidingen
Vragen en antwoorden
Kan ik de API direct vanuit de browser aanroepen?
Dat kan, maar dan maak je je sleutel zichtbaar voor elke bezoeker. Houd de sleutel op een server en exposeer alleen je eigen route.
Hoe voorkom ik dat het model de acties van mijn personage schrijft?
Geef dit op in de system prompt en voeg, bij gebruik van een transcriptformaat, een stopsequentie toe. Beide methoden werken met de doorgeefparameters.
Moet de app gesprekken opslaan?
De API zelf is stateless, dus je stuurt de geschiedenis bij elke beurt opnieuw. Prompts worden niet gebruikt voor training.
Wat is de goedkoopste manier om te prototypen?
Gebruik de proefsleutel en een Map in het geheugen. Schakel over op een database en een betaalde sleutel zodra de lus werkt.
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 aanvragen