Chatbot API Entegrasyonu: Uygulamanıza Bir Sohbet Uç Noktası Bağlayın
Bir chatbot API entegrasyonunun atlanamayan tek kuralı vardır: tarayıcı API anahtarını asla tutmaz. Ortaya küçük bir arka uç proxy'si koyun, yanıtları onun üzerinden akış olarak gönderin ve geri kalanı sıradan web geliştirmesidir.
güncellendi

Temel noktalar
- Tarayıcı sunucunuza konuşur; sunucunuz anahtarla sohbet API'sine konuşur.
- Yanıtlar kelime kelime görünsün diye sunucu tarafından gönderilen olaylarla (SSE) akış yapın.
- Geçmişi sınırlayın, kullanıcı başına limitler ayarlayın ve kısa bir bekleme ile 429 yanıtlarını yönetin.
- Uç nokta OpenAI-uyumludur, bu nedenle Base URL değişikliğinden sonra resmi SDK çalışır.
Bir resimde desen
Her güvenli chatbot api entegrasyonu yukarıdan bakıldığında aynı görünür. Tarayıcıdaki bir sayfa, kullanıcının mesajını kendi uç noktanıza gönderir. Sunucunuz sistem istemini ekler, geçmişi kısaltır, API anahtarını ekler ve çağrıyı iletir. Yanıt aynı şekilde geri akış yapar.
Browser --POST /api/chat--> Your server --POST /v1/chat/completions--> Chat API
Browser <--SSE stream------ Your server <--SSE stream----------------- Chat API
Proxy dört nedenle vardır: anahtarı gizler, kimin konuştuğunu kontrol etmenizi sağlar, kullanıcı başı maliyeti sınırlamanızı sağlar ve model ayarlarını daha sonra değiştirmek için tek bir yer verir. Ön uç JavaScript'ine yerleştirilen bir anahtar, sayfa yüklendiği anda halka açıktır ve başkası ön ödemeli kredinizi harcayabilir.
API OpenAI formatını izler. Base URL https://api.uncensoredchatbotapi.com/v1, model uncensored ve kimlik doğrulama Authorization: Bearer YOUR_KEY şeklindedir. Anahtarı anahtar sayfasından edinin.
Adım 1: sunucu proxy'si
Bu Express sunucusu bir konuşma kabul eder, bir sistem istemi ekler, akışlı olarak API'yi çağırır ve metni iletir. Bağımlılıkları npm i express openai ile yükleyin ve ortamda CHAT_API_KEY ayarlayın.
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);
Filtreye dikkat edin. İstemci her şeyi gönderebilir, bu nedenle sunucu yalnızca user ve assistant mesajlarını tutar, her birini kısaltır ve tarayıcının enjekte etmeye çalıştığı herhangi bir system mesajını yok sayar. Sistem istemi her zaman kodunuzdan gelir.
Adım 2: tarayıcı tarafı
Tarayıcı, fetch ile akışı okur ve metni geldikçe ekler. Herhangi bir kütüphaneye gerek yoktur.
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 });
}
Arabellek önemlidir. Ağ parçaları olay sınırlarıyla hizalanmaz, bu nedenle boş satırda bölünür ve sonraki okuma için tamamlanmamış kuyruğu tutulur. Sayfanın kendisi için bir adım adım kılavuz için web sohbet öğreticisine bakın ve bir siteye bot ekleme hakkında daha geniş resim için bir web sitesinde chatbot nasıl uygulanır.
Limitler, hatalar ve yeniden denemeler
Tam anahtar 8 eşzamanlı istek ve dakikada 300 istek izni verir. Deneme anahtarı ise 2 ve 60 izni verir. Akışlı bir istek, akış bitene kadar slotunu işgal eder; bu nedenle 8 slotla aynı anda en fazla 8 canlı yanıt sunabilirsiniz. Sitenizdeki eşzamanlı kullanıcı sayısı bu sayıdan fazlaysa, istekleri sunucunuzda kuyruğa alın ve hata vermek yerine "bir dakika" yanıtını verin.
concurrencyile 429: uçuşta çok fazla istek var. Kuyruğa alın ve yeniden deneyin.rate_limitedile 429: dakika başına çok fazla istek. Yavaşlayın.Retry-After: 5başlığıyla 429: geçici aşırı yüklenme. 5 saniye bekleyin ve tekrar deneyin.- 401: yanlış veya eksik anahtar.
- 8 MB üzeri gövde: reddedilir, bu nedenle gönderdiklerinizi kısaltın.
Kendi sunucunuzun asla 8 yukarı akış akışını açmaması için küçük bir bellek içi sayaç ekleyin:
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();
});
Bu ara yazılımı sohbet rotasından önce kaydedin. close olayı yanıt bittiğinde veya kullanıcı ayrıldığında tetiklenir, bu nedenle sayaç sızdırmaz.
Her konuşmanın maliyetini kontrol edin
Fiyat, 1M girdi token başı $0,15 ve 1M çıktı token başı $0,50'dir. Her dönüş geçmiş verisini yeniden gönderdiği için, geçmiş için olan sınır en büyük etkeninizdir. Son 20 mesajın her biri yaklaşık 60 token ve bir 100 token'lık sistem istemi ile bir istek yaklaşık 1.300 girdi token taşır. 150 token'lık bir yanıt çıktı ekler.
Dönüş başı maliyet: 1.300 / 1.000.000 x $0,15 = $0,000195, artı 150 / 1.000.000 x $0,50 = $0,000075, yani $0,00027. Bu boyutta bir 30 dönüşlü oturum, erken dönüşler daha kısa olduğu için en fazla $0,0081'e mal olur. Kullanıcı başı günlük limitler (örneğin 100 mesaj), en kötü durumu kullanıcı başı günde $0,027 ile sınırlar. Bir site botunun fiyatlandırılması hakkında daha fazla bilgi için web sitesinde chatbot maliyeti sayfasını okuyun ve max_tokens gibi parametreler için belgeleri kullanın.
Proxy'nizi kim çağırıyor
Proxy anahtarı korur, ancak aynı zamanda URL'yi bulan herkes için ücretsiz bir sohbet uç noktası haline gelir. Yayınlamadan önce kimin kullanabileceğine karar verin.
Halka açık bir site için, oturum açma sırasında ayarlanan imzalı bir oturum çerezi genellikle cevaptır. Rotanın başında kontrol edin ve eksikse 401 döndürün. Hızlı bir prototip için, express-rate-limit gibi bir paketle IP başına limit, hiçbir şeyden iyidir, ancak paylaşılan ağlar IP limitlerini kalınlaştırır. Ne seçerseniz seçin, bağlantı başına değil, kullanıcı başına mesaj sayın ve sayımı yeniden başlatmanın sıfırlayamayacağı bir yerde saklayın.
Uygulama büyüdükçe konuşma geçmişini sunucuda tutun. Her dönüşte tüm geçmişi tarayıcıdan göndermek kurması kolaydır, ancak kullanıcılar bunu düzenleyebilir. Mesajları bir konuşma kimliği altında bir veritabanında saklayın, her istekte son 20'sini yükleyin ve akış bittikten sonra yanıtı ekleyin. Bu, bir kullanıcının sekmeyi kapatıp aynı sohbete geri dönmesine de olanak tanır.
Yayınlamadan önce
Kısa bir kontrol listesi, lansman gününü sessiz tutar.
- Anahtar yalnızca sunucudaki bir ortam değişkeninde saklanır ve depo içinde yer almaz.
- Sunucu, istemciden gelen herhangi bir sistem mesajını yok sayar.
- Her kullanıcının günlük mesaj limiti ve mesaj uzunluğu limiti vardır.
- Hatalar dostça bir mesaj gösterir ve dahili ayrıntıları asla yazdırmaz.
- İstek kimliklerini
X-Request-Idbaşlığından ve token sayılarını, tam metni değil, günlüğe kaydedersiniz. X-Balance-USD'i izlersiniz ve kredi azaldığında uyarı alırsınız.- Şartlarınız yalnızca yetişkin kitleyi belirtir ve bot reşit olmayanların yer aldığı cinsel içerik asla üretmez.
Son nokta, yetişkin chatbot güvenliği rehberliğiyle paylaşılır. Bu API'nin arkasındaki model, yasal yetişkin kullanım için içerik reddi olmadan cevap verecek şekilde ayarlanmıştır; bu da kendi yaş doğrulama ve moderasyon kurallarınızı daha önemli kılar, azaltmaz. Bakiye yükleme burada yalnızca kripto ile yapılır (TRC20 üzerinde USDT veya Base üzerinde USDC), $20 ile $500 arasındadır ve yeni kullanıcılar önce $0,50 deneme kredisi talep edebilir.
Daha fazla kılavuz
Sorular ve cevaplar
API'yi tarayıcıdaki JavaScript'ten doğrudan neden çağıramıyorum?
Çünkü anahtar, ağ sekmesini açan herkes için görünür olur. Bir arka uç proxy'si anahtarı sunucunuzda tutar ve kullanıcı başına limit eklemenizi sağlar.
API akış desteği sunuyor mu?
Evet. Akışı true olarak ayarlayın ve API, sonunda kullanım bilgileriyle birlikte sunucu gönderilen olayları gönderir. Vekil sunucunuz bu olayları tarayıcıya iletebilir.
Hangi SDK'yı kullanmalıyım?
Herhangi bir OpenAI SDK veya HTTP istemcisi çalışır. Temel URL'yi https://api.uncensoredchatbotapi.com/v1 olarak değiştirin, anahtarınızı kullanın ve modeli uncensored olarak ayarlayın.
Çok fazla kullanıcı aynı anda sohbet ederse ne olur?
Tam anahtar 8 eşzamanlı isteklere izin verir. Bunun ötesinde API, concurrency hatasıyla 429 döndürür; bu nedenle ek istekleri sunucunuzda kuyruğa alın ve kısa bir süre sonra yeniden deneyin.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın ve base URL'yi değiştirin. Kurulum bu kadar basit.