Intégration de l'API Chatbot : Connectez un endpoint de chat à votre application
Une intégration d'API de chatbot a une règle que vous ne pouvez pas ignorer : le navigateur ne conserve jamais la clé API. Placez un petit proxy backend au milieu, diffusez les réponses via celui-ci, et le reste est du développement web ordinaire.
Mis à jour le

Points clés
- Le navigateur parle à votre serveur ; votre serveur parle à l'API de chat avec la clé.
- Diffusez avec des événements envoyés par le serveur pour que les réponses apparaissent mot par mot.
- Limitez l'historique, définissez des limites par utilisateur et gérez les réponses 429 avec une courte attente.
- L'endpoint est compatible OpenAI, donc le SDK officiel fonctionne après un changement d'URL de base.
Le schéma dans une image
Chaque intégration d'API de chatbot sécurisée ressemble à la même chose de loin. Une page dans le navigateur envoie le message de l'utilisateur à votre propre endpoint. Votre serveur ajoute le prompt système, réduit l'historique, attache la clé API et transmet l'appel. La réponse revient en streaming de la même manière.
Browser --POST /api/chat--> Your server --POST /v1/chat/completions--> Chat API
Browser <--SSE stream------ Your server <--SSE stream----------------- Chat API
Le proxy existe pour quatre raisons : il cache la clé, il vous permet de vérifier qui appelle, il vous permet de limiter le coût par utilisateur, et il vous donne un seul endroit pour modifier les paramètres du modèle plus tard. Une clé placée dans le JavaScript front-end est publique dès le chargement de la page, et quelqu'un d'autre dépensera votre crédit prépayé.
L'API suit le format OpenAI. L'URL de base est https://api.uncensoredchatbotapi.com/v1, le modèle est uncensored, et l'authentification est Authorization: Bearer YOUR_KEY. Obtenez une clé sur la page des clés.
Étape 1 : le proxy serveur
Ce serveur Express accepte une conversation, ajoute un prompt système, appelle l'API avec streaming et relaie le texte. Installez les dépendances avec npm i express openai et définissez CHAT_API_KEY dans l'environnement.
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);
Notez le filtre. Le client peut envoyer n'importe quoi, donc le serveur ne garde que les messages user et assistant, les tronque et ignore tout message system que le navigateur essaie d'injecter. Le prompt système vient toujours de votre code.
Étape 2 : le côté navigateur
Le navigateur lit le flux avec fetch et ajoute du texte à mesure qu'il arrive. Aucune bibliothèque n'est requise.
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 });
}
Le buffer est important. Les blocs réseau ne s'alignent pas sur les limites d'événements, donc vous divisez sur la ligne vide et gardez le reste inachevé pour la prochaine lecture. Pour un guide de la page elle-même, consultez le tutoriel de chat web, et pour une vue plus large sur l'ajout d'un bot à un site, comment implémenter un chatbot dans un site web.
Limites, erreurs et tentatives
Une clé complète permet 8 requêtes simultanées et 300 par minute. Une clé d'essai permet 2 requêtes simultanées et 60 par minute. Une requête streamée occupe son emplacement jusqu'à la fin du flux, donc avec 8 emplacements vous pouvez servir au plus 8 réponses en direct à la fois. Si votre site a plus d'utilisateurs simultanés que cela, mettez les requêtes en file d'attente sur votre serveur et répondez « un instant » au lieu d'échouer.
- 429 avec
concurrency: trop de requêtes sont en cours. Mettez en file d'attente et réessayez. - 429 avec
rate_limited: trop de requêtes par minute. Ralentissez. - 429 avec un en-tête
Retry-After: 5: surcharge temporaire. Attendez 5 secondes et réessayez. - 401: clé incorrecte ou manquante.
- Corps supérieur à 8 Mo : rejeté, donc réduisez ce que vous envoyez.
Ajoutez un petit compteur en mémoire pour que votre propre serveur n'ouvre jamais plus de 8 flux amont :
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();
});
Enregistrez ce middleware avant la route de chat. L'événement close se déclenche lorsque la réponse se termine ou que l'utilisateur part, donc le compteur ne fuit pas.
Contrôlez le coût de chaque conversation
Le prix est de $0,15 par 1M de tokens d'entrée et de $0,50 par 1M de tokens de sortie. Comme chaque tour renvoie l'historique, la limite sur l'historique est votre levier principal. Avec les 20 derniers messages à environ 60 tokens chacun plus un prompt système de 100 tokens, une requête contient environ 1 300 tokens d'entrée. Une réponse de 150 tokens ajoute des tokens de sortie.
Coût par tour : 1 300 / 1 000 000 x 0,15 $ = 0,000195 $, plus 150 / 1 000 000 x 0,50 $ = 0,000075 $, donc 0,00027 $. Une session de 30 tours de cette taille coûte au plus 0,0081 $, car les premiers tours sont plus courts. Des limites quotidiennes par utilisateur, par exemple 100 messages, bornent votre pire cas à 100 x 0,00027 $ = 0,027 $ par utilisateur par jour. Pour plus sur le prix d'un bot de site, lisez la page sur le coût du chatbot sur le site web, et utilisez la documentation pour des paramètres tels que max_tokens.
Qui appelle votre proxy
Le proxy protège la clé, mais il devient aussi un endpoint de chat gratuit pour quiconque trouve l'URL. Décidez qui peut l'utiliser avant de lancer.
Pour un site public, un cookie de session signé défini à la connexion est la réponse habituelle. Vérifiez-le en haut de la route et renvoyez 401 quand il manque. Pour un prototype rapide, une limite par IP avec un package tel que express-rate-limit est mieux que rien, bien que les réseaux partagés rendent les limites IP grossières. Quel que soit votre choix, comptez les messages par utilisateur, pas par connexion, et stockez le compte où un redémarrage ne peut pas le réinitialiser.
Conservez l'historique de conversation sur le serveur une fois que l'application grandit. Envoyer tout l'historique depuis le navigateur à chaque tour est facile à construire, mais les utilisateurs peuvent le modifier. Stockez les messages dans une base de données sous un id de conversation, chargez les 20 derniers à chaque requête, et ajoutez la réponse après la fin du streaming. Cela permet aussi à un utilisateur de fermer l'onglet et de revenir à la même conversation.
Avant le lancement
Une courte liste de contrôle garde le jour de lancement calme.
- La clé vit uniquement dans une variable d'environnement sur le serveur, et le dépôt ne la contient pas.
- Le serveur ignore tout message système du client.
- Chaque utilisateur a une limite de messages par jour et une limite de longueur de message.
- Les erreurs affichent un message convivial et n'impriment jamais de détails internes.
- Vous enregistrez les ids de requête de l'en-tête
X-Request-Idet les nombres de tokens, et non le texte complet. - Vous surveillez
X-Balance-USDet obtenez une alerte lorsque le crédit est faible. - Vos conditions stipulent un public adulte uniquement, et le bot ne produit jamais de contenu sexuel impliquant des mineurs.
Le dernier point est partagé avec les directives sur la sécurité des chatbots pour adultes. Le modèle derrière cette API est ajusté pour répondre sans refus de contenu pour une utilisation adulte légale, ce qui rend vos propres règles de filtrage d'âge et de modération plus importantes, pas moins. Les recharges ici sont en crypto uniquement (USDT sur TRC20 ou USDC sur Base), de $20 à $500, et les nouveaux utilisateurs peuvent réclamer un essai de $0,50 d'abord.
Plus de guides
Questions et réponses
Pourquoi ne puis-je pas appeler l'API directement depuis JavaScript dans le navigateur ?
Parce que la clé serait visible par quiconque ouvre l'onglet réseau. Un proxy backend garde la clé sur votre serveur et vous permet d'ajouter des limites par utilisateur.
L'API prend-elle en charge le streaming ?
Oui. Définissez stream sur true et l'API envoie des événements envoyés par le serveur, avec l'utilisation à la fin. Votre proxy peut relayer ces événements au navigateur.
Quel SDK dois-je utiliser ?
Tout SDK OpenAI ou client HTTP fonctionne. Modifiez l'URL de base pour https://api.uncensoredchatbotapi.com/v1, utilisez votre clé et définissez le modèle sur uncensored.
Que se passe-t-il si trop d'utilisateurs discutent en même temps ?
Une clé complète permet 8 requêtes simultanées. Au-delà, l'API renvoie 429 avec le code concurrency, donc mettez en file d'attente les requêtes supplémentaires sur votre serveur et réessayez peu de temps après.
Votre clé est à un formulaire d'ici
Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.