TH ▾
Uncensored Chatbot APIการเข้าถึง API โดยตรงไปยัง LLM แบบไร้การเซ็นเซอร์หนึ่งตัวรับคีย์ API

Uncensored Chatbot APIความปลอดภัย

วิธีสร้างแชทบอทบนเว็บไซต์ แบบทีละขั้นตอน แบบทีละขั้นตอน แบบทีละขั้นตอน

การเรียนรู้วิธีสร้างแชทบอทในโครงการเว็บไซต์แบ่งออกเป็นสามส่วน: กล่องแชทในเบราว์เซอร์ เบ็กเอนด์ขนาดเล็กที่เก็บคีย์ API ของคุณ และการเรียกใช้เอนด์พอยต์ที่เข้ากันได้กับ OpenAI คู่มือนี้สร้างแต่ละส่วนด้วยโค้ดที่ใช้งานได้

อัปเดต

ปุ่มแชทในเบราว์เซอร์ที่เชื่อมต่อผ่านเซิร์ฟเวอร์ที่เก็บคีย์ไปยัง API บนคลาวด์ แสดงวิธีการเพิ่มแชทบอทลงในเว็บไซต์

ประเด็นสำคัญ

  • อย่าเรียกใช้ API จากโค้ดเบราว์เซอร์เป็นอันขาด เก็บคีย์ไว้ที่เซิร์ฟเวอร์และเปิดเผยเส้นทาง /api/chat ของคุณเอง
  • API นี้เข้ากันได้กับ OpenAI ดังนั้น SDK มาตรฐานจึงใช้งานได้หลังจากที่คุณตั้งค่า Base URL และใช้โมเดล uncensored
  • ใช้การตอบแบบสตรีมมิงเพื่อให้หน้าเว็บดูรวดเร็ว และจำกัดประวัติข้อความที่เซิร์ฟเวอร์
  • จัดการการตอบกลับ 429 และตั้งค่าขีดจำกัดต่อผู้เยี่ยมชม เนื่องจากคีย์เต็มรูปแบบอนุญาตให้ทำคำขอพร้อมกัน (concurrent requests) ได้ 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."}]}'

การเรียกครั้งแรกจะแสดงรายการโมเดล และการเรียกครั้งที่สองจะคืนค่า chat completion หากทั้งสองอย่างสำเร็จ แสดงว่าคีย์และ Base URL ถูกต้อง หากได้ 401 แสดงว่าคีย์ไม่ถูกต้องหรือขาด Bearer หน้าตัด

ขั้นตอนที่ 2: เขียนเส้นทางแบ็กเอนด์

ตัวอย่างด้านล่างใช้ Node 18 ขึ้นไป Express และแพ็คเกจ openai ทางการ ติดตั้งด้วย npm install express openai และตั้งค่า "type": "module" ใน package.json

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 มันใช้ JavaScript ธรรมดาไม่มีเฟรมเวิร์ก ดังนั้นคุณสามารถวางลงในเทมเพลตที่มีอยู่แล้วได้

<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 สำหรับจำนวนคำขอที่มากเกินไปในครั้งเดียว เมื่อโหลดเกินชั่วคราว มันยังส่ง 429 พร้อมหัว Retry-After: 5

กฎปฏิบัติสองข้อที่ตามมาคือ ประการแรก ลองใหม่เมื่อได้ 429 หลังจากช่วงเวลาที่กำหนดโดยเพิ่มเวลาถอยหลังเล็กน้อย และแสดงข้อความที่เป็นมิตรแก่ผู้เยี่ยมชมหากยังคงล้มเหลว ประการที่สอง จำไว้ว่าคำขอสตรีมมิงจะยึดช่องคำขอพร้อมกันจนกว่าสตรีมจะสิ้นสุด หากผู้เยี่ยมชมสิบคนสตรีมพร้อมกันบนคีย์เต็ม สองคนจะถูกปฏิเสธ ดังนั้นเพิ่มคิวขนาดเล็กหรือจำกัดต่อผู้เยี่ยมชมบนเซิร์ฟเวอร์ของคุณ ตัวนับในหน่วยความจำที่คีย์ด้วย IP เพียงพอสำหรับเว็บไซต์ขนาดเล็ก

หัวตอบกลับช่วยคุณแก้ไขข้อบกพร่อง: X-Request-Id ระบุการเรียกหากคุณติดต่อฝ่ายสนับสนุน และ X-Balance-USD แสดงเครดิตคงเหลือของคุณ ขีดจำกัดขนาดบอดี้คำขอคือ 8 MB ซึ่งสูงกว่าสิ่งที่แชทต้องการมาก และหน้าต่างบริบทคือ 100,000 โทเคน

กับดักเมื่อคุณปรับใช้

โค้ดด้านบนทำงานบน localhost นี่คือปัญหาที่ปรากฏเมื่ออยู่บนเซิร์ฟเวอร์จริง

  • พร็อกซีบัฟเฟอร์ พร็อกซีย้อนกลับบางตัวเก็บการตอบกลับสตรีมมิงไว้จนกว่าจะเสร็จสิ้น ทำให้ข้อความปรากฏพร้อมกันทั้งหมด หากคุณใช้ nginx ให้ปิดการบัฟเฟอร์การตอบกลับสำหรับเส้นทางแชท ทดสอบสตรีมมิงผ่านเชนพร็อกซีเดียวกันที่คุณใช้ในสภาพแวดล้อมการผลิต ไม่ใช่แค่บนแล็ปท็อปของคุณ
  • คีย์ในที่เก็บโค้ด เก็บคีย์ในตัวแปรสภาพแวดล้อมหรือที่เก็บความลับและเพิ่มไฟล์สภาพแวดล้อมท้องถิ่นใดๆ ในรายการที่เพิกเฉย หากคีย์ปรากฏในที่เก็บสาธารณะ สร้างคีย์ใหม่และหยุดใช้คีย์เก่า
  • การไว้วางใจไคลเอนต์ เบราว์เซอร์ส่งประวัติการแชท ดังนั้นผู้เยี่ยมชมสามารถแก้ไขได้ นั่นคือเหตุผลที่เซิร์ฟเวอร์ในขั้นตอนที่ 2 กำหนดบทบาทเองและตัดความยาวข้อความ อย่ายอมรับข้อความระบบจากไคลเอนต์
  • คำขอข้ามต้นทาง หากหน้าเว็บและแบ็กเอนด์ของคุณอยู่บนโดเมนที่แตกต่างกัน เบราว์เซอร์จะบล็อกคำขอจนกว่าเซิร์ฟเวอร์ของคุณจะส่งหัว CORS ที่ถูกต้อง การให้บริการทั้งสองจากต้นทางเดียวกันช่วยหลีกเลี่ยงปัญหานี้
  • ค่าใช้จ่ายที่ควบคุมไม่ได้ ผู้เยี่ยมชมที่เขียนสคริปต์สามารถส่งข้อความได้หลายร้อยข้อความ นับคำขอต่อ IP หรือเซสชันบนเซิร์ฟเวอร์และปฏิเสธเมื่อจำนวนสูงเกินไป นอกจากนี้จำกัดความยาวข้อความตามที่ตัวอย่างทำ
  • มาร์กอัปและลิงก์ โมเดลมักตอบกลับด้วยรายการและโค้ดเฟนซ์ ตัดสินใจว่าคุณจะเรนเดอร์สิ่งนั้นหรือแสดงข้อความธรรมดา และอย่าแทรกข้อความตอบกลับเป็น HTML ดิบ

การตรวจสอบสุดท้ายคือเลย์เอาต์บนมือถือ การจราจรแชทส่วนใหญ่บนเว็บไซต์สาธารณะมาจากโทรศัพท์ ดังนั้นทดสอบด้วยหน้าจอแคบ คีย์บอร์ดซอฟต์แวร์เปิด และการเชื่อมต่อที่ไม่เสถียร หากสตรีมขาดตอนกลางทาง ผู้เยี่ยมชมควรสามารถส่งใหม่โดยไม่สูญเสียเนื้อหา

การขยายบอทในภายหลัง

เมื่อการรีเลย์พื้นฐานทำงาน เส้นทางเดียวกันสามารถทำงานเพิ่มเติมได้ เพราะ API รองรับฟีเจอร์มาตรฐานของ OpenAI คุณสามารถขอผลลัพธ์ที่มีโครงสร้างด้วยโหมด JSON โดยตั้งค่า response_format เป็น {"type": "json_object"} และระบุในพรอมต์ว่าข้อความตอบกลับต้องเป็น JSON สิ่งนี้เหมาะสำหรับแบบฟอร์มลีดที่เปลี่ยนข้อความที่ผู้ใช้ป้อนเป็นฟิลด์เช่น ชื่อ หัวข้อ และความเร่งด่วน

การเรียกใช้เครื่องมือช่วยให้โมเดลขอให้คุณเซิร์ฟเวอร์รันฟังก์ชัน เช่น การค้นหาคำสั่งหรือตรวจสอบเวลาเปิดทำการ คุณส่งรายการ tools อ่าน tool_calls ในการตอบกลับ รันฟังก์ชันเอง และส่งผลลัพธ์กลับเป็นข้อความด้วย role: "tool" จากนั้นโมเดลจะเขียนคำตอบสุดท้ายจากข้อมูลของคุณ นี่คือวิธีที่บอทเว็บไซต์ได้รับข้อมูลจริงแทนที่จะคาดเดา

การตั้งค่า Sampling เปิดให้คุณปรับได้ ค่า temperature ต่ำเหมาะสำหรับศูนย์ช่วยเหลือเชิงข้อเท็จจริง ส่วนค่าสูงเหมาะสำหรับการเล่าเรื่อง เพิ่มการเปลี่ยนแปลงทีละอย่างแล้วเปรียบเทียบผลลัพธ์จากคำถามทดสอบ 5 ข้อเดียวกัน

ขั้นตอนที่ 5: ปรับแต่งบอทและเริ่มใช้งาน

พรอมต์ระบบกำหนดตัวตนของบอทของคุณ บอกมันว่าคือใคร ครอบคลุมเรื่องอะไร และคำตอบควรยาวแค่ไหน หากตัวละครมีบุคลิก เคล็ดลับใน การออกแบบบุคลิก จะเจาะลึกลงไป เนื่องจากโมเดลถูกปรับแต่งให้ตอบโดยไม่มีการปฏิเสธเนื้อหาสำหรับการใช้งานผู้ใหญ่ที่ถูกต้องตามกฎหมาย มาตรการป้องกันสำหรับกลุ่มเป้าหมายของคุณจึงเป็นสิ่งที่คุณต้องเขียนเอง: การยืนยันอายุ ลิงก์รายงาน และรายการชัดเจนว่าบอทจะไม่พูดถึงเนื้อหาใด เนื้อหาทางเพศที่เกี่ยวข้องกับผู้เยาว์ไม่อนุญาตเด็ดขาด โปรดดูหน้า การใช้งานอย่างรับผิดชอบและมาตรการป้องกัน ก่อนเปิดตัว

ด้านค่าใช้จ่าย คุณจ่าย $0.15 ต่อ 1M input tokens และ $0.50 ต่อ 1M output tokens คำตอบที่มี input tokens 1,200 และ output tokens 300 มีค่าใช้จ่าย $0.00018 บวก $0.00015 ซึ่งรวมเป็น $0.00033 การเติมเงิน $20 ครอบคลุมการตอบคำถามลักษณะนี้ได้มากกว่า 60,000 ครั้ง การเติมเงินเริ่มต้นที่ $20 ถึง $500 พร้อมโบนัส +5% จาก $50, +10% จาก $100 และ +15% จาก $200 ชำระด้วย USDT บน TRC20 หรือ USDC บน Base เครดิตไม่หมดอายุ หน้า ราคา มีรายละเอียด และ เอกสาร ระบุพารามิเตอร์ที่รองรับทั้งหมด รวมถึงการเรียกใช้ฟังก์ชันและโหมด JSON

ก่อนเปิดตัว ให้ทดสอบด้วยการสนทนาที่ยาวๆ สักสองสามครั้ง ตรวจสอบบันทึกสำหรับ 429s และยืนยันว่าเซิร์ฟเวอร์ของคุณตัดประวัติให้สั้นลง พรอมต์ไม่ถูกนำไปใช้ในการฝึก แต่คุณควรแจ้งให้ผู้เยี่ยมชมของคุณทราบว่าคุณจัดเก็บข้อมูลใด

ถาม-ตอบ

ฉันสามารถเรียก API โดยตรงจาก JavaScript ในเบราว์เซอร์ได้หรือไม่?

ทำได้ แต่ไม่ควรทำ คีย์จะปรากฏต่อผู้เยี่ยมชมทุกคน ให้ส่งคำขอผ่านเซิร์ฟเวอร์ของคุณเองและเก็บคีย์ไว้ในตัวแปรสภาพแวดล้อม

ภาษาและ SDK ใดบ้างที่ใช้งานได้?

SDK ของ OpenAI หรือไคลเอนต์ HTTP ใดๆ ก็ได้ ตั้งค่า base URL เป็น https://api.uncensoredchatbotapi.com/v1, ใช้คีย์ของคุณเป็น bearer token และตั้งค่าโมเดลเป็น uncensored. Python, Node และ curl ใช้งานได้ทั้งหมด

สตรีมมิงใช้งานได้บนเบราว์เซอร์หรือไม่?

ได้ API สตรีมผ่าน SSE โดยตั้งค่า stream เป็น true ตัวอย่างในเอกสารจะส่งต่อข้อความผ่านเซิร์ฟเวอร์ของคุณโดยใช้ fetch และ stream reader

เกิดอะไรขึ้นเมื่อถึงขีดจำกัดอัตรา?

คุณจะได้รับ HTTP 429 พร้อมรหัส rate_limited หรือ concurrency ให้รอและลองใหม่ สำหรับกรณีโอเวอร์โหลดชั่วคราว ค่าของส่วนหัว Retry-After คือ 5 วินาที

คีย์ของคุณอยู่ห่างแค่แบบฟอร์มเดียว

สร้างบัญชี คัดลอกคีย์ และเปลี่ยน base URL นั่นคือการตั้งค่าทั้งหมด

รับคีย์ APIอ่านเอกสาร