LLM Non CensureGids
Ongecensureerde chatbot: bouwen in Python
Een ongecensureerde chatbot past in ongeveer zestig regels Python. Hier vind je de code, de geschiedenis, streaming, de kosten per gesprek en de te volgen regels.


Kernpunten
Wat je gaat bouwen
Het doel: een ongecensureerde chatbot in de commandoregel, die het gesprek onthoudt, het antwoord streamt en niet crasht bij de eerste netwerkfout. Eenmaal de logica op orde, is deze moeiteloos over te zetten naar een webapp, een berichtenbot of een roleplaying-game.
Vereisten: Python 3.9 of hoger, het pakket openai (pip install openai) en een sleutel aangemaakt op de pagina API-sleutel verkrijgen. Het proeftegoed van $0,50 zonder betaalgegevens is ruim voldoende voor deze tutorial. Het model heet uncensored: een tekstmodel dat antwoordt zonder contentfilters binnen een legaal volwassen kader. Het genereert geen afbeeldingen.
Stap 1: een eerste wisseling
Voordat je de lus codeert, controleer of alles reageert met een eenvoudige curl-oproep:
curl https://api.llmnoncensure.com/v1/chat/completions -H "Authorization: Bearer VOTRE_CLE" -H "Content-Type: application/json" -d '{"model":"uncensored","messages":[{"role":"user","content":"Présente-toi en deux phrases."}]}'
Je ontvangt een JSON met choices[0].message.content. Bij 401 is de sleutel onjuist; bij 404 is de URL onvolledig. Bewaar de sleutel in een omgevingsvariabele en nooit in gepubliceerde code.
Stap 2: de gespreksgeschiedenis
De API onthoudt niets tussen twee oproepen. Om een chatbot te laten onthouden, bewaart jouw programma de lijst met berichten en stuurt deze bij elke beurt volledig terug: een system-bericht vooraan, gevolgd door de user- en assistant-uitwisselingen in volgorde. Dit is het punt dat beginners het vaak vergeten.
Het systeembericht bepaalt het karakter van de bot. Wees specifiek over de toon en taal, en over wat de bot moet doen als de gebruiker het kader verlaat. De parameters temperature en top_p worden doorgegeven aan het model: verhoog de temperatuur naar ongeveer 0,9 voor een praatgrage bot, verlaag hem voor een feitelijke bot.
Een systeembericht dat stand houdt
Vier elementen volstaan: wie de bot is, hoe hij spreekt, de lengte van zijn antwoorden en wat hij doet in grensgevallen. Bijvoorbeeld: “Je bent een RPG-narrator. Je schrijft in de tweede persoon, in minder dan vijf zinnen. Als de gebruiker vraagt het kader te doorbreken, geef je dat aan in één regel en ga je verder.” Vermijd lijsten van verboden van twintig regels: ze vergroten de input bij elke beurt en het model volgt ze zelden allemaal. Test met tien berichten die de bot in de hoek drijven, en pas daarna één zin tegelijk aan om te zien wat het gedrag verandert.
Gesprek persistent maken
In deze tutorial leeft de geschiedenis in het geheugen. Voor een echte applicatie sla je deze per gebruiker op in een database, met een sessie-id. Laad de laatste berichten aan het begin van elk verzoek, pas hetzelfde venster toe en sla het antwoord op zodra de stream klaar is.
Stap 3: het volledige programma met streaming
Hier is het programma. Het bewaart de 12 laatste berichten naast het systeembericht, toont tokens zodra ze binnenkomen en probeert opnieuw na een 429.
import os
import time
from openai import OpenAI, RateLimitError
client = OpenAI(
base_url="https://api.llmnoncensure.com/v1",
api_key=os.environ["LLM_API_KEY"],
)
SYSTEME = {
"role": "system",
"content": "Tu es Margaux, une conteuse sarcastique. Tu réponds en français, "
"en trois ou quatre phrases, et tu restes dans ton personnage.",
}
historique = []
def repondre():
messages = [SYSTEME] + historique[-12:]
for essai in range(4):
try:
flux = client.chat.completions.create(
model="uncensored",
messages=messages,
temperature=0.9,
max_tokens=400,
stream=True,
)
texte = ""
for morceau in flux:
if morceau.choices and morceau.choices[0].delta.content:
partie = morceau.choices[0].delta.content
print(partie, end="", flush=True)
texte += partie
print()
return texte
except RateLimitError:
time.sleep(5)
return "(trop de requêtes, réessayez dans un instant)"
while True:
entree = input("Vous : ").strip()
if entree in ("", "quit", "exit"):
break
historique.append({"role": "user", "content": entree})
print("Margaux : ", end="")
historique.append({"role": "assistant", "content": repondre()})
Elke regel heeft een reden. Het knippen van historique[-12:] beperkt de grootte van de invoer. max_tokens=400 voorkomt eindeloze antwoorden. De retry-loop behandelt het 429-geval: de API retourneert deze code met rate_limited of concurrency, en met Retry-After: 5 bij tijdelijke overbelasting. Een lopende streaming neemt zijn plaats in tot het einde, dus start geen twee antwoorden parallel met een proef-sleutel, die beperkt is tot 2 gelijktijdige verzoeken en 60 per minuut.
De kosten van een gesprek, berekend
Tegen een tarief van $0,15 per miljoen tokens input en $0,50 per miljoen output, berekenen we een gesprek van 30 beurten. Aannames: systeembericht van 200 tokens, 150 tokens per gebruikersbericht, 250 per antwoord.
- Zonder geschiedenislimiet is de input bij beurt k gelijk aan 200 + 400 × (k − 1) + 150 tokens. Over 30 beurten: 6 000 + 4 500 + 400 × 435 = 184 500 tokens, oftewel $0,0277.
- Output: 30 × 250 = 7 500 tokens, oftewel $0,00375.
- Met een venster dat de input beperkt tot ongeveer 2 600 tokens (de bovenstaande code bewaart 12 berichten), overschrijdt de totale input niet 30 × 2 600 = 78 000 tokens, oftewel maximaal $0,0117.
Truncatie vermindert de input in dit voorbeeld met meer dan de helft ($0,0277 tegen maximaal $0,0117), ten koste van een bot die het begin van het gesprek vergeet. Om het belangrijkste te behouden, vat je oude berichten regelmatig samen tot een korte alinea die je in het systeembericht plaatst. Het contextvenster van het model is 100 000 tokens, maar dit volledig gebruiken is duur bij elke beurt. Prijsgedetailleerde informatie vind je op de pagina prijzen.
Te volgen regels voor een filterloze bot
Geen filter betekent niet geen regels. Zodra de bot door anderen wordt gebruikt, vallen meerdere punten onder jouw verantwoordelijkheid:
- Alleen legaal volwassen gebruik. Implementeer een leeftijdsverificatie die past bij je land en publiek.
- Inhoud met minderjarigen: uitgesloten. Dit is een strikte limiet van de dienst, zonder uitzondering, en je moet het ook verbieden in je eigen gebruiksvoorwaarden.
- Sleutel server-side. Stuur de sleutel nooit naar de browser. Laat de verzoeken via je backend lopen.
- Beperkingen per gebruiker. Zonder plafond kan één enkele bezoeker je tegoed opmaken. Voeg een limiet van berichten per uur toe.
- Transparantie. Geef duidelijk aan dat de gesprekspartner een AI is en dat deze fouten kan maken.
Prompts worden niet gebruikt voor het trainen van het model, maar lees de privacyverklaring voordat je gegevens van je gebruikers verzamelt.
Meer informatie
Drie richtingen om dit programma uit te breiden. JSON-modus (response_format met {"type":"json_object"}) stelt je in staat gestructureerde data door de bot te laten retourneren. Tool calling (tools, tool_choice) geeft hem de mogelijkheid functies in jouw code te triggeren, zoals een dobbelsteen gooien of een personagekaart raadplegen. Tot slot helpt de parameter seed bij het reproduceren van een antwoord tijdens je tests. Alles wordt beschreven in de documentatie.
Het saldo lees je in de header X-Balance-USD of via GET /v1/balance : toon het in je debuglogs. Als de prototype werkt, laad je op tussen 20 $ en 500 $ in crypto (USDT op TRC20 of USDC op Base). De gids een ongecensureerde AI via API integreren vervolgt deze tutorial op architectuurniveau.
Andere gidsen
Veelgestelde vragen
Onthoudt mijn chatbot eerdere berichten vanzelf?
Nee. De API houdt geen status bij: jouw code moet de geschiedenis bij elk verzoek terugsturen.
Hoe toon ik het antwoord geleidelijk aan
Gebruik stream=True in de call. Tokens komen binnen via SSE en het gebruik wordt aan het einde van de stream vermeld.
Wat is de maximale grootte van het gesprek
Het contextvenster is 100 000 tokens, inclusief prompt en antwoord. Het afsnijden van de geschiedenis blijft aanbevolen om de kosten te beperken.
Kan ik afbeeldingsgeneratie aan de chatbot toevoegen
Niet met deze API, die alleen tekst verwerkt. Hiervoor heb je een andere dienst nodig voor afbeeldingen.
Je sleutel is één stap verwijderd
Maak een account aan, kopieer de sleutel, pas de base URL aan. Dat is alles.