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

ประเด็นสำคัญ
- อย่าเรียกใช้ 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 นั่นคือการตั้งค่าทั้งหมด