Cara Mengimplementasikan Chatbot di Website, Langkah demi Langkah
Belajar cara mengimplementasikan chatbot dalam proyek website berpusat pada tiga bagian: kotak obrolan di browser, backend kecil yang menyimpan kunci API Anda, dan panggilan ke endpoint yang kompatibel OpenAI. Panduan ini membangun setiap bagian dengan kode yang berfungsi.
Diperbarui

Poin utama
- Jangan pernah memanggil API dari kode browser. Simpan kunci di server dan ekspos rute /api/chat Anda sendiri.
- API kompatibel dengan OpenAI, sehingga SDK standar berfungsi setelah Anda mengatur base URL dan menggunakan model uncensored.
- Stream balasan agar halaman terasa cepat, dan batasi riwayat di server.
- Tangani respons 429 dan tetapkan batas per pengunjung, karena kunci penuh memungkinkan 8 permintaan konkuren.
Arsitektur dalam satu gambar
Cara umum untuk mengimplementasikan chatbot dalam proyek website adalah relay tiga langkah. Pengunjung mengetik ke kotak obrolan. Halaman Anda mengirim pesan ke server Anda sendiri. Server Anda memanggil API model dengan kunci rahasia Anda dan meneruskan kembali jawabannya. Browser tidak pernah melihat kunci tersebut.
Ini penting karena apa pun dalam JavaScript front-end bersifat publik. Jika Anda menempatkan kunci dalam tag script, siapa saja yang membuka alat pengembang dapat menyalinnya dan menghabiskan saldo Anda. Rute backend juga memberi Anda satu tempat untuk menambahkan batas laju, pemangkasan riwayat, logging, dan gerbang usia. Untuk panduan lebih lanjut tentang halaman yang selesai, lihat tutorial web chat.
Langkah 1: dapatkan kunci dan uji endpoint
Daftar dengan Google atau dengan email dan kata sandi, lalu klaim uji coba gratis di halaman kunci API. Uji coba adalah kredit $0,50, berlaku selama 7 hari, satu per orang, dan tidak memerlukan pembayaran. Simpan kunci sebagai variabel lingkungan, bukan dalam kode Anda.
Periksa bahwa itu berfungsi dengan curl sebelum menulis kode aplikasi apa pun:
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."}]}'Panggilan pertama mencantumkan model dan panggilan kedua mengembalikan penyelesaian obrolan. Jika keduanya berhasil, kunci dan base URL benar. 401 berarti kunci salah atau hilang awalan Bearer.
Langkah 2: tulis rute backend
Contoh di bawah ini menggunakan Node 18 atau yang lebih baru, Express, dan paket openai resmi. Instal dengan npm install express openai dan atur "type": "module" di 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"));Tiga detail melakukan pekerjaan utama di sini. Server membangun kembali daftar pesan sendiri, sehingga pengunjung tidak dapat menyuntikkan pesan sistem palsu. Server hanya menyimpan 10 pesan terakhir dan membatasi panjang setiap pesan menjadi 4.000 karakter, yang mengontrol biaya. Dan server selalu mengatur peran secara eksplisit, memetakan apa pun yang tidak dikenal ke user.
Langkah 3: bangun kotak obrolan
Masukkan ini ke dalam public/index.html. Ini menggunakan JavaScript murni tanpa kerangka kerja, sehingga Anda dapat menempelkannya ke template yang ada.
<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>Menggunakan textContent alih-alih innerHTML untuk output model mencegah balasan menyuntikkan markup ke halaman Anda. Pertahankan kebiasaan itu bahkan ketika model berperilaku baik.
Langkah 4: tangani batas dan kesalahan
Kunci penuh memungkinkan 8 permintaan konkuren dan 300 permintaan per menit. Kunci uji coba memungkinkan 2 konkuren dan 60 per menit. Ketika Anda melebihi batas, API mengembalikan HTTP 429 dengan kode kesalahan: rate_limited untuk permintaan per menit atau concurrency untuk terlalu banyak sekaligus. Saat kelebihan beban sementara, API juga mengembalikan 429 dengan header Retry-After: 5.
Dua aturan praktis mengikuti. Pertama, coba ulang 429 setelah jeda dengan backoff singkat, dan tampilkan pesan ramah kepada pengunjung jika terus gagal. Kedua, ingat bahwa permintaan yang di-stream memegang slot konkurensinya hingga stream berakhir. Jika sepuluh pengunjung melakukan streaming sekaligus pada kunci penuh, dua di antaranya akan ditolak, jadi tambahkan antrian kecil atau batas per pengunjung di server Anda. Penghitung memori sederhana yang dikunci berdasarkan IP sudah cukup untuk situs kecil.
Header respons membantu Anda men-debug: X-Request-Id mengidentifikasi panggilan jika Anda menghubungi dukungan, dan X-Balance-USD menampilkan sisa saldo Anda. Batas tubuh permintaan adalah 8 MB, jauh di atas yang dibutuhkan obrolan, dan jendela konteks adalah 100.000 token.
Jebakan saat Anda melakukan peluncuran
Kode di atas berfungsi di localhost. Ini adalah masalah yang muncul setelah kode tersebut berada di server nyata.
- Proxy penyangga. Beberapa proxy terbalik menahan respons streaming hingga selesai, sehingga balasan muncul sekaligus. Jika Anda menggunakan nginx, matikan penyangga respons untuk rute obrolan. Uji streaming melalui rantai proxy yang sama dengan yang Anda gunakan di produksi, bukan hanya di laptop Anda.
- Kunci di repositori. Simpan kunci dalam variabel lingkungan atau toko rahasia dan tambahkan file env lokal apa pun ke daftar abaikan Anda. Jika kunci pernah jatuh ke repositori publik, buat kunci baru dan hentikan penggunaan kunci lama.
- Mempercayai klien. Browser mengirim riwayat obrolan, sehingga pengunjung dapat mengeditnya. Itulah mengapa server pada langkah 2 mengatur peran sendiri dan memotong panjang pesan. Jangan pernah menerima pesan sistem dari klien.
- Panggilan lintas asal. Jika halaman dan backend Anda berada di domain yang berbeda, browser akan memblokir permintaan hingga server Anda mengirim header CORS yang tepat. Mengirim keduanya dari satu asal menghindari masalah ini.
- Biaya yang tidak terkendali. Satu pengunjung yang terotomatisasi dapat mengirim ratusan pesan. Hitung permintaan per IP atau sesi di server dan tolak ketika jumlahnya terlalu tinggi. Juga batasi panjang pesan, seperti yang dilakukan contoh.
- Markdown dan tautan. Model sering membalas dengan daftar dan pagar kode. Putuskan apakah Anda merender itu atau menampilkan teks biasa, dan jangan pernah menyisipkan teks balasan sebagai HTML mentah.
Pemeriksaan terakhir adalah tata letak seluler. Sebagian besar lalu lintas obrolan di situs publik berasal dari ponsel, jadi uji dengan layar sempit, keyboard perangkat lunak terbuka, dan koneksi tidak stabil. Jika aliran terputus di tengah jalan, pengunjung harus dapat mengirim ulang tanpa kehilangan konteks.
Memperluas bot nanti
Setelah relay dasar berfungsi, rute yang sama dapat melakukan lebih banyak, karena API mendukung fitur OpenAI standar. Anda dapat meminta output terstruktur dengan mode JSON dengan mengatur response_format ke {"type": "json_object"} dan mengatakan dalam prompt bahwa balasan harus berupa JSON. Itu cocok untuk formulir prospek yang mengubah pesan teks bebas menjadi bidang seperti nama, topik, dan urgensi.
Pemanggilan fungsi memungkinkan model meminta server Anda menjalankan fungsi, seperti mencari pesanan atau memeriksa jam buka. Anda meneruskan daftar tools, membaca tool_calls dalam respons, menjalankan fungsi sendiri, dan mengirim kembali hasilnya sebagai pesan dengan role: "tool". Model kemudian menulis jawaban akhir dari data Anda. Inilah cara bot website mendapatkan informasi nyata bukan menebak-nebak.
Pengaturan sampling juga terbuka untuk Anda. Suhu yang lebih rendah cocok untuk pusat bantuan faktual dan suhu yang lebih tinggi cocok untuk bercerita. Tambahkan satu perubahan pada satu waktu dan bandingkan hasilnya pada lima pertanyaan uji yang sama.
Langkah 5: bentuk bot dan luncurkan
Prompt sistem mendefinisikan bot Anda. Beritahu bot itu siapa dirinya, apa yang dicakupnya, dan berapa lama jawaban harus berlangsung. Jika karakter tersebut memiliki kepribadian, catatan tentang desain kepribadian akan lebih mendalam. Karena model ini disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah, pagar pembatas untuk audiens Anda adalah tanggung jawab Anda untuk menulis: konfirmasi usia, tautan pelaporan, dan daftar jelas apa yang tidak akan dibahas bot. Konten seksual yang melibatkan anak di bawah umur tidak pernah diizinkan. Lihat halaman penggunaan bertanggung jawab dan pengaman sebelum peluncuran.
Dari segi biaya, Anda membayar $0,15 per 1M token input dan $0,50 per 1M token output. Balasan dengan 1.200 token input dan 300 token output berharga $0,00018 ditambah $0,00015, yang merupakan $0,00033. Top-up $20 mencakup lebih dari 60.000 balasan seperti itu. Top-up dimulai dari $20 hingga $500, dengan +5% dari $50, +10% dari $100, dan +15% dari $200, dibayar dalam USDT di TRC20 atau USDC di Base. Kredit tidak pernah kedaluwarsa. halaman harga memiliki detailnya, dan dokumentasi mencantumkan setiap parameter yang didukung, termasuk pemanggilan fungsi dan mode JSON.
Sebelum Anda meluncurkan, uji dengan beberapa percakapan panjang, pantau log untuk 429s, dan konfirmasi bahwa server Anda memangkas riwayat. Prompt tidak digunakan untuk pelatihan, tetapi Anda masih harus memberi tahu pengunjung Anda apa yang Anda simpan.
Lebih banyak panduan
Pertanyaan dan jawaban
Bisakah Anda memanggil API langsung dari JavaScript browser?
Anda bisa, tetapi sebaiknya tidak. Kunci akan terlihat oleh setiap pengunjung. Arahkan permintaan melalui server Anda sendiri dan simpan kunci dalam variabel lingkungan.
Bahasa dan SDK apa saja yang berfungsi?
SDK OpenAI atau klien HTTP apa pun. Atur URL dasar ke https://api.uncensoredchatbotapi.com/v1, gunakan kunci Anda sebagai token bearer, dan atur model ke uncensored. Python, Node, dan curl semuanya berfungsi.
Apakah streaming berfungsi di browser?
Ya. API melakukan streaming melalui SSE dengan stream diatur ke true. Contoh meneruskan teks melalui server Anda menggunakan fetch dan pembaca stream.
Apa yang terjadi saat Anda mencapai batas laju?
Anda mendapatkan HTTP 429 dengan kode rate_limited atau concurrency. Tunggu dan retry. Untuk kelebihan beban sementara, header Retry-After adalah 5 detik.
Kunci Anda hanya selangkah lagi dari satu formulir
Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh proses pengaturannya.