Mis à jour le
Application de jeu de rôle IA sans filtre : créez-la avec une API
Une API IA petite amie fournit une interface dédiée aux applications de chat qui simulent des interactions romantiques ou de compagnie à l’aide de grands modèles de langage. Ce guide compare les approches techniques, en se concentrant sur les modèles sans censure qui gèrent le contexte de jeu de rôle sans les refus de contenu standards.

L'architecture en une image
Le navigateur envoie le message de l'utilisateur à votre serveur. Votre serveur ajoute la personnalité et l'historique récent, appelle le modèle avec stream: true, et transmet chaque fragment. Rien d'autre n'est requis.
- Navigateur : une zone de texte et un div qui grandit à mesure que les tokens arrivent.
- Votre serveur : conserve la clé API, construit la liste des messages, applique vos propres limites par utilisateur.
- Modèle API :
POST /v1/chat/completionsàhttps://api.nofilterai.top/v1avec le modèleuncensored. - Stockage : une table ou un fichier de messages par conversation. SQLite suffit pour commencer.
Le modèle est un modèle à poids ouverts, ajusté pour répondre sans refus de contenu pour une utilisation adulte légale. Il est textuel uniquement. Si vous voulez de l'art de personnage ou de la voix, ajoutez un autre service vous-même.
Concevez le prompt système
Pour le jeu de rôle, le prompt système fait la majeure partie du travail. Divisez-le en trois courts blocs afin que vous puissiez échanger chacun indépendamment : le monde, le personnage et les règles du format.
{
"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."
}
Joignez-les en un seul message système au moment de la requête. Les garder séparés permet aux utilisateurs de choisir un monde et un personnage indépendamment, ce qui est la majeure partie de ce dont une application de jeu de rôle a besoin. Parce que la fiction adulte est autorisée pour une utilisation adulte légale, dites-le une fois dans vos propres conditions générales et ajoutez une vérification d'âge. La seule chose que l'API ne produira pas est du contenu sexuel impliquant des mineurs, et votre application ne devrait pas essayer.
Le backend en streaming
Cette route Express accepte un ID de conversation et un message, charge l'historique, et transmet le flux vers le navigateur en tant qu'événements envoyés par le serveur. Elle utilise le package officiel openai.
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);
Le dernier fragment d'un flux contient l'utilisation, que vous pouvez logger pour voir combien coûte chaque conversation. En production, remplacez le Map par une base de données et ajoutez une gestion des erreurs autour de l'appel.
Réduisez l'historique dans la fenêtre 100k tokens
La fenêtre de contexte est de 100 000 tokens pour le prompt plus la réponse. Les sessions de jeu de rôle grandissent lentement, mais elles grandissent. Une fonction de réduction qui fonctionne par taille évite les surprises. Une estimation approximative de 4 caractères par token est suffisante pour le budget.
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 caractères représentent environ 30 000 tokens, bien en dessous de la limite, et cela garde chaque appel peu coûteux. Augmentez-le uniquement si votre histoire nécessite une longue mémoire. Rappelez-vous la règle de coût : chaque tour renvoie l'historique conservé en entrée à $0,15 par 1M tokens, donc un prompt de 30 000 tokens coûte 30 000 / 1 000 000 x $0,15 = $0,0045 par tour avant la réponse.
Le client navigateur
La page lit le flux SSE avec fetch et ajoute du texte à mesure qu'il arrive. Parce que la requête est un POST, EventSource ne convient pas, alors analysez le flux à la main.
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));
}
}
}
}Les fonctionnalités qui donnent l'impression d'une application
- Régénération et modification. Conservez les IDs de message. Régénérer signifie supprimer le dernier message de l'assistant et appeler à nouveau l'API avec le même historique. Modifier signifie réécrire un message stocké avant l'appel suivant.
- Paramètres par personnage. Stockez
temperature,top_pet les pénalités avec chaque personnage. Les personnages plus calmes aiment 0,7, les chaotiques aiment 1,0. Passezseedlorsque vous voulez des exécutions de test reproductibles. - Affichage du coût. Lisez l'en-tête de réponse
X-Balance-USDou appelezGET /v1/balanceet affichez à l'utilisateur combien de crédit reste. Si vous revendez l'accès à vos propres utilisateurs, cela vous économise beaucoup de questions de support. - Barrières de sécurité sous votre contrôle. Ajoutez un contrôle d'accès adultes uniquement, un bouton de signalement et une règle qui bloque toute requête impliquant des mineurs avant qu'elle n'atteigne l'API. La plateforme applique également cette limite, mais votre application devrait le faire aussi.
Limites, erreurs et budgets
Une clé complète permet 8 requêtes simultanées et 300 requêtes par minute. Une requête en streaming occupe un slot de concurrence jusqu'à la fin du flux, donc une application de jeu de rôle avec 20 utilisateurs actifs atteindra le cap pendant les minutes chargées. L'API répond HTTP 429 avec le code concurrency ou rate_limited, et en cas de surcharge temporaire, elle ajoute Retry-After: 5. Mettez en file d'attente les requêtes sur votre serveur et réessayez après ce délai.
Les requêtes échouées ou refusées ne sont pas facturées, donc les nouvelles tentatives ne vous coûtent rien. Pour le budget, un échange typique de 3 000 tokens d'entrée et 300 tokens de sortie coûte $0,00045 + $0,00015 = $0,0006. Le crédit est prépayé à partir de $20 et n'expire jamais. Ce site accepte la crypto, USDT sur TRC20 ou USDC sur Base ; la page de tarification liste les bonus à partir de $50.
Où aller ensuite
Obtenez une clé et testez avec l'essai gratuit : la page des clés API offre $0,50 de crédit après l'inscription, valable 7 jours, sans détails de paiement. La clé d'essai permet 2 requêtes simultanées, suffisantes pour un prototype à un seul utilisateur. La documentation liste chaque paramètre, y compris l'appel de fonctions si vous voulez gérer les jets de dés ou l'inventaire comme des appels de fonctions.
Pour une variante de style compagnon avec un personnage persistant unique, consultez l'article API Compagnon IA. Pour un bot de chat dans un serveur, lisez le guide bot Discord.
Plus de guides
Questions et réponses
Puis-je appeler l'API directement depuis le navigateur ?
Vous le pouvez, mais vous exposeriez votre clé à tous les visiteurs. Gardez la clé sur un serveur et exposez uniquement votre propre point de terminaison.
Comment empêcher le modèle d'écrire les actions de mon personnage ?
Indiquez-le dans le prompt système et, si vous utilisez un format de transcription, ajoutez une séquence d'arrêt. Les deux fonctionnent avec les paramètres de passage.
L'application doit-elle stocker les conversations ?
L'API elle-même est sans état, donc vous renvoyez l'historique à chaque tour. Les prompts ne sont pas utilisés pour l'entraînement.
Quelle est la méthode la moins chère pour prototyper ?
Utilisez la clé d'essai et une Map en mémoire. Passez à une base de données et une clé avec crédit une fois la boucle fonctionnelle.
Obtenez votre clé en un formulaire
Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.
Obtenir une clé API