HI ▾
Uncensored Chatbot APIएक बिना सेंसर LLM तक सीधा API एक्सेसAPI कुंजी पाएँ

Uncensored Chatbot APIसुरक्षा

वेबसाइट में चैटबॉट कैसे लागू करें, चरण-दर-चरण

वेबसाइट प्रोजेक्ट्स में चैटबॉट लागू करना सीखने से तीन भागों में बंटता है: ब्राउज़र में एक चैट बॉक्स, एक छोटा बैकएंड जो आपकी API कुंजी रखता है, और एक OpenAI-कम्पैटिबल एंडपॉइंट पर कॉल। यह गाइड प्रत्येक भाग को काम करने वाले कोड के साथ बनाती है।

अपडेट किया गया

ब्राउज़र में चैट बबल जो एक कुंजी-धारक सर्वर के माध्यम से क्लाउड API से जुड़ा है, यह दिखाता है कि वेबसाइट में चैटबॉट कैसे जोड़ें

मुख्य बिंदु

  • ब्राउज़र कोड से कभी API को कॉल न करें। कुंजी को सर्वर पर रखें और अपना खुद का /api/chat राउट एक्सपोज़ करें।
  • API OpenAI-संगत है, इसलिए मानक SDK बेस URL सेट करने और uncensored मॉडल का उपयोग करने के बाद काम करते हैं।
  • प्रतिक्रियाओं को स्ट्रीम करें ताकि पेज तेज़ लगे, और सर्वर पर इतिहास को सीमित करें।
  • 429 प्रतिक्रियाओं को हैंडल करें और प्रति-आगंतुक सीमा निर्धारित करें, क्योंकि एक फुल कुंजी 8 समानांतर अनुरोधों की अनुमति देती है।

एक तस्वीर में आर्किटेक्चर

वेबसाइट प्रोजेक्टों में चैटबॉट लागू करने का सामान्य तरीका एक तीन-चरणीय रिले है। आगंतुक चैट बॉक्स में टाइप करता है। आपका पेज संदेश को अपने खुद के सर्वर पर भेजता है। आपका सर्वर आपकी सीक्रेट कुंजी के साथ मॉडल API को कॉल करता है और जवाब वापस पास करता है। ब्राउज़र कभी कुंजी नहीं देखता।

यह महत्वपूर्ण है क्योंकि फ्रंट-एंड JavaScript में कुछ भी सार्वजनिक होता है। यदि आप कुंजी को स्क्रिप्ट टैग में डालते हैं, तो डेवलपर टूल्स खोलने वाला कोई भी उसे कॉपी कर सकता है और आपका बैलेंस खर्च कर सकता है। एक बैकएंड रूट आपको रेट लिमिट्स, इतिहास ट्रिमिंग, लॉगिंग और आयु सीमा जोड़ने के लिए एक जगह भी देता है। एक पूर्ण पेज के विस्तृत विवरण के लिए, वेब चैट ट्यूटोरियल देखें।

चरण 1: एक कुंजी प्राप्त करें और एंडपॉइंट का परीक्षण करें

Google या ईमेल और पासवर्ड से साइन इन करें, फिर API कुंजी पेज पर मुफ़्त ट्रायल क्रेडिट क्लेम करें। ट्रायल में $0.50 का क्रेडिट मिलता है, जो 7 दिनों के लिए मान्य है, प्रति व्यक्ति एक बार, और इसके लिए भुगतान की आवश्यकता नहीं है। कुंजी को अपने कोड में नहीं, बल्कि एक पर्यावरण चर के रूप में सहेजें।

कोई भी ऐप कोड लिखने से पहले curl से जांचें कि यह काम कर रहा है या नहीं:

export API_KEY="YOUR_KEY"

curl https://api.uncensoredchatbotapi.com/v1/models -H "Authorization: Bearer $API_KEY"

curl https://api.uncensoredchatbotapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "messages": [{"role": "user", "content": "Say hello in five words."}]}'

पहला कॉल मॉडल की सूची देता है और दूसरा चैट पूर्णता लौटाता है। यदि दोनों सफल होते हैं, तो कुंजी और बेस URL सही हैं। 401 का मतलब है कि कुंजी गलत है या Bearer उपसर्ग के बिना है।

स्टेप 2: बैकएंड रूट लिखें

नीचे दिया गया उदाहरण Node 18 या उससे नए वर्जन, Express और आधिकारिक openai पैकेज का उपयोग करता है। इन्हें npm install express openai से इंस्टॉल करें और package.json में "type": "module" सेट करें।

import express from "express";
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.uncensoredchatbotapi.com/v1",
  apiKey: process.env.API_KEY,
});

const SYSTEM = "You are a helpful assistant for our website. Keep answers under 150 words.";

const app = express();
app.use(express.json({ limit: "100kb" }));
app.use(express.static("public"));

app.post("/api/chat", async (req, res) => {
  const incoming = Array.isArray(req.body.messages) ? req.body.messages : [];
  const history = incoming.slice(-10).map((m) => ({
    role: m.role === "assistant" ? "assistant" : "user",
    content: String(m.content).slice(0, 4000),
  }));

  try {
    const stream = await client.chat.completions.create({
      model: "uncensored",
      messages: [{ role: "system", content: SYSTEM }, ...history],
      stream: true,
    });
    res.setHeader("Content-Type", "text/plain; charset=utf-8");
    for await (const chunk of stream) {
      const text = chunk.choices[0]?.delta?.content;
      if (text) res.write(text);
    }
  } catch (err) {
    if (res.headersSent === false) res.status(err.status === 429 ? 429 : 502);
  }
  res.end();
});

app.listen(3000, () => console.log("Listening on http://localhost:3000"));

तीन बातें यहाँ असली काम करती हैं। सर्वर संदेश सूची को स्वयं पुनर्निर्मित करता है, इसलिए एक आगंतुक एक झूठा सिस्टम संदेश इंजेक्ट नहीं कर सकता। यह केवल अंतिम 10 संदेशों को रखता है और प्रत्येक को 4,000 वर्णों तक काट देता है, जिससे लागत नियंत्रित होती है। और यह हमेशा भूमिकाओं को स्पष्ट रूप से सेट करता है, अज्ञात किसी भी चीज़ को user में मैप करके।

स्टेप 3: चैट बॉक्स बनाएं

इसे public/index.html में डालें। यह सादे जावास्क्रिप्ट का उपयोग करता है, बिना किसी फ्रेमवर्क के, इसलिए आप इसे मौजूदा टेम्पलेट में पेस्ट कर सकते हैं।

<div id="log"></div>
<form id="form">
  <input id="input" autocomplete="off" required />
  <button>Send</button>
</form>
<script>
const messages = [];
const log = document.getElementById("log");

document.getElementById("form").addEventListener("submit", async (e) => {
  e.preventDefault();
  const input = document.getElementById("input");
  messages.push({ role: "user", content: input.value });
  log.insertAdjacentHTML("beforeend", "<p></p>");
  log.lastElementChild.textContent = "You: " + input.value;
  input.value = "";

  const reply = document.createElement("p");
  log.appendChild(reply);
  const res = await fetch("/api/chat", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ messages }),
  });
  if (res.ok === false) { reply.textContent = "Busy, please try again in a moment."; return; }

  const reader = res.body.getReader();
  const decoder = new TextDecoder();
  let full = "";
  while (true) {
    const { done, value } = await reader.read();
    if (done) break;
    full += decoder.decode(value, { stream: true });
    reply.textContent = full;
  }
  messages.push({ role: "assistant", content: full });
});
</script>

मॉडल आउटपुट के लिए textContent का उपयोग innerHTML के बजाय करने से प्रतिक्रिया में मार्कअप इंजेक्ट होने से बचा जाता है। इस आदत को तब भी बनाए रखें जब मॉडल अच्छा व्यवहार कर रहा हो।

स्टेप 4: लिमिट और एरर्स हैंडल करें

एक पूर्ण कुंजी 8 समकालीक अनुरोधों और प्रति मिनट 300 अनुरोधों की अनुमति देती है। एक ट्रायल कुंजी 2 समकालीक और प्रति मिनट 60 की अनुमति देती है। जब आप सीमा पार करते हैं, तो API HTTP 429 लौटाता है एक त्रुटि कोड के साथ: rate_limited प्रति मिनट अनुरोधों के लिए या concurrency एक साथ बहुत अधिक अनुरोधों के लिए। अस्थायी ओवरलोड पर यह Retry-After: 5 हेडर के साथ 429 भी लौटाता है।

दो व्यावहारिक नियम हैं। पहला, 429 त्रुटि पर विलंबता के बाद छोटे बैकऑफ़ के साथ पुनः प्रयास करें, और यदि यह लगातार विफल रहता है तो दर्शक को एक मित्रपूर्ण संदेश दिखाएं। दूसरा, याद रखें कि एक स्ट्रीम किए गए अनुरोध में समानांतर स्लॉट तब तक बंधा रहता है जब तक स्ट्रीम समाप्त नहीं हो जाती। यदि एक पूर्ण कुंजी पर दस आगंतुक एक साथ स्ट्रीम करते हैं, तो उनमें से दो को अस्वीकार कर दिया जाएगा, इसलिए अपने सर्वर पर एक छोटा कतार या प्रति-आगंतुक सीमा जोड़ें। एक सरल इन-मेमोरी काउंटर जो IP द्वारा कुंजीबद्ध है, एक छोटी साइट के लिए पर्याप्त है।

प्रतिक्रिया हेडर आपको डीबग करने में मदद करते हैं: X-Request-Id एक कॉल की पहचान करता है यदि आप सहायता से संपर्क करते हैं, और X-Balance-USD आपका शेष क्रेडिट दिखाता है। अनुरोध बॉडी सीमा 8 MB है, जो एक चैट की आवश्यकता से कहीं अधिक है, और कॉन्टेक्स्ट विंडो 100,000 टोकन है।

डिप्लॉय करते समय सावधानियां

ऊपर दिया गया कोड localhost पर काम करता है। ये वे समस्याएं हैं जो एक असली सर्वर पर आने पर सामने आती हैं।

  • बफरिंग प्रॉक्सी। कुछ रिवर्स प्रॉक्सी स्ट्रीम किए गए प्रतिक्रियाओं को समाप्त होने तक रोकते हैं, इसलिए उत्तर एक साथ दिखाई देता है। यदि आप nginx का उपयोग करते हैं, तो चैट राउट के लिए रिस्पॉन्स बफरिंग बंद करें। प्रोडक्शन में उपयोग की जाने वाली उसी प्रॉक्सी चेन के माध्यम से स्ट्रीमिंग का परीक्षण करें, न कि केवल अपने लैपटॉप पर।
  • रिपॉजिटरी में कुंजियां। कुंजी को एक एन्वायरनमेंट वेरिएबल या सीक्रेट्स स्टोर में रखें और किसी भी लोकल एनवी फ़ाइल को अपनी इग्नोर लिस्ट में जोड़ें। यदि कभी कुंजी एक पब्लिक रिपॉजिटरी में आ जाती है, तो एक नई बनाएं और पुरानी का उपयोग बंद कर दें।
  • क्लाइंट पर भरोसा। ब्राउज़र चैट हिस्ट्री भेजता है, इसलिए कोई आगंतुक उसे एडिट कर सकता है। इसलिए स्टेप 2 में सर्वर खुद भूमिका सेट करता है और मैसेज लेंथ काट देता है। क्लाइंट से सिस्टम मैसेज कभी स्वीकार न करें।
  • क्रॉस-ओरिजिन कॉल्स। यदि आपकी पेज और बैकएंड अलग-अलग डोमेन पर हैं, तो ब्राउज़र अनुरोध को ब्लॉक कर देगा जब तक कि आपका सर्वर सही CORS हेडर न भेजे। एक ही ओरिजिन से दोनों सर्व करना इस समस्या से बचाता है।
  • बेकाबू लागत। एक स्क्रिप्टेड विज़िटर सैकड़ों मैसेज भेज सकता है। सर्वर पर IP या सेशन के हिसाब से अनुरोधों की गिनती करें और जब गिनती बहुत अधिक हो तो मना कर दें। उदाहरण की तरह ही मैसेज लेंथ को भी कैप करें।
  • मार्कडाउन और लिंक। मॉडल अक्सर सूचियों और कोड फेंस के साथ प्रतिक्रिया देते हैं। तय करें कि आप उसे रेंडर करेंगे या सादे टेक्स्ट दिखाएंगे, और प्रतिक्रिया टेक्स्ट को कच्चा HTML के रूप में कभी न डालें।

एक आखिरी जांच मोबाइल लेआउट की है। पब्लिक साइट्स पर चैट ट्रैफिक का ज्यादातर हिस्सा फोन से आता है, इसलिए नार्ो स्क्रीन, खुले सॉफ्टवेयर कीबोर्ड और फ्लैकी कनेक्शन के साथ टेस्ट करें। यदि स्ट्रीम बीच में टूट जाती है, तो विज़िटर को बिना थ्रेड खोए फिर से भेजने की क्षमता होनी चाहिए।

बॉट को बाद में एक्सटेंड करना

एक बार जब बेसिक रिले काम कर लेता है, तो उसी रूट से अधिक काम हो सकता है, क्योंकि API मानक OpenAI सुविधाओं का समर्थन करता है। आप response_format को {"type": "json_object"} पर सेट करके JSON मोड के साथ संरचित आउटपुट मांग सकते हैं और प्रॉम्प्ट में कह सकते हैं कि प्रतिक्रिया JSON होनी चाहिए। यह एक लीड फॉर्म के लिए उपयुक्त है जो एक फ्री-टेक्स्ट संदेश को नाम, विषय और आपातकाल जैसे फ़ील्ड्स में बदल देता है।

फ़ंक्शन कॉलिंग मॉडल को आपकी सर्वर पर एक फ़ंक्शन चलाने के लिए कहने देती है, जैसे ऑर्डर की खोज या खुलने के समय की जाँच। आप एक tools सूची पास करते हैं, प्रतिक्रिया में tool_calls पढ़ते हैं, फ़ंक्शन स्वयं चलाते हैं, और परिणाम role: "tool" संदेश के रूप में वापस भेजते हैं। मॉडल फिर आपके डेटा से अंतिम उत्तर लिखता है। यह एक वेबसाइट बॉट को अनुमान लगाने के बजाय वास्तविक जानकारी प्राप्त करने का तरीका है।

सैम्पलिंग सेटिंग्स भी आपके लिए खुली हैं। कम तापमान तथ्यात्मक हेल्पडेस्क के लिए उपयुक्त है और उच्च तापमान कहानी कहने के लिए। एक बार में एक बदलाव जोड़ें और पाँच परीक्षण प्रश्नों पर परिणामों की तुलना करें।

चरण 5: बॉट को आकार दें और लाइव करें

सिस्टम प्रॉम्प्ट आपके बॉट को परिभाषित करता है। इसे बताएं कि वह कौन है, वह किस विषय को कवर करता है और उत्तर कितने लंबे होने चाहिए। यदि चरित्र की एक व्यक्तित्व है, तो व्यक्तित्व डिज़ाइन पर नोट्स अधिक गहराई से जाते हैं। चूंकि मॉडल कानूनी वयस्क उपयोग के लिए सामग्री अस्वीकृति के बिना उत्तर देने के लिए ट्यून्ड है, इसलिए आपके दर्शकों के लिए गार्डरेल्स आपकी लिखी हुई हैं: एक आयु पुष्टि, एक रिपोर्ट लिंक और एक स्पष्ट सूची कि बॉट किस बात पर चर्चा नहीं करेगा। नाबालिगों से जुड़ी यौन सामग्री कभी भी अनुमत नहीं है। लॉन्च से पहले जिम्मेदार उपयोग और सुरक्षा उपाय पृष्ठ देखें।

लागत के बारे में, आप 1M इनपुट टोकन के लिए $0.15 और 1M आउटपुट टोकन के लिए $0.50 देते हैं। 1,200 इनपुट टोकन और 300 आउटपुट टोकन वाले एक जवाब की लागत $0.00018 प्लस $0.00015 है, जो कि $0.00033 है। एक $20 टॉप-अप 60,000 से अधिक ऐसे जवाबों को कवर करता है। टॉप-अप $20 से $500 तक चलते हैं, $50 से +5%, $100 से +10% और $200 से +15% बोनस, USDT on TRC20 या USDC on Base में भुगतान करें। क्रेडिट कभी समाप्त नहीं होता। मूल्य निर्धारण पृष्ठ विवरण रखता है, और दस्तावेज़ हर समर्थित पैरामीटर की सूची बनाता है, जिसमें फ़ंक्शन कॉलिंग और JSON मोड शामिल हैं।

लॉन्च करने से पहले, कुछ लंबी बातचीत के साथ परीक्षण करें, 429s के लिए लॉग देखें, और पुष्टि करें कि आपका सर्वर इतिहास को ट्रिम करता है। प्रॉम्प्ट प्रशिक्षण के लिए उपयोग नहीं किए जाते हैं, लेकिन आपको अपने आगंतुकों को यह बताना चाहिए कि आप क्या स्टोर करते हैं।

प्रश्न और उत्तर

क्या मैं ब्राउज़र जावास्क्रिप्ट से सीधे API को कॉल कर सकता हूँ?

आप ऐसा कर सकते हैं, लेकिन आपको नहीं करना चाहिए। कुंजी हर आगंतुक के लिए दिखाई देगी। अनुरोधों को अपने स्वयं के सर्वर के माध्यम से रूट करें और कुंजी को एक पर्यावरण चर में रखें।

कौन सी भाषाएँ और SDK काम करते हैं?

कोई भी OpenAI SDK या HTTP क्लाइंट। बेस URL को https://api.uncensoredchatbotapi.com/v1, पर सेट करें, अपनी API कुंजी को Bearer टोकन के रूप में उपयोग करें और मॉडल को uncensored पर सेट करें। Python, Node और curl सभी काम करते हैं।

क्या ब्राउज़र में स्ट्रीमिंग काम करती है?

हाँ। API, stream को true सेट करके SSE के माध्यम से स्ट्रीम करता है। उदाहरण fetch और स्ट्रीम रीडर का उपयोग करके टेक्स्ट को आपके सर्वर के माध्यम से रिले करता है।

जब मैं रेट लिमिट पर पहुँचता हूँ तो क्या होता है?

आपको HTTP 429 मिलता है जिसमें rate_limited या concurrency कोड होता है। प्रतीक्षा करें और पुनः प्रयास करें। अस्थायी ओवरलोड के लिए Retry-After हेडर 5 सेकंड होता है।

आपकी कुंजी बस एक फ़ॉर्म दूर है

एक खाता बनाएँ, कुंजी कॉपी करें, बेस URL बदलें। सेटअप यही है।

API कुंजी प्राप्त करेंदस्तावेज़ पढ़ें