Integrasi API Chatbot: Sambungkan Endpoint Chat ke Aplikasi Anda
Integrasi API chatbot memiliki satu aturan yang tidak boleh dilewatkan: browser tidak pernah memegang kunci API. Pasang proxy backend kecil di tengah, alirkan balasan melaluinya, dan sisanya adalah pengembangan web biasa.
Diperbarui

Poin utama
- Browser berbicara ke server Anda; server Anda berbicara ke API chat dengan kunci.
- Alirkan dengan event server-sent agar balasan muncul kata demi kata.
- Batasi riwayat, atur batas per pengguna, dan tangani respons 429 dengan jeda singkat.
- Endpoint ini kompatibel dengan OpenAI, sehingga SDK resmi berfungsi setelah perubahan base URL.
Pola dalam satu gambar
Setiap integrasi chatbot api yang aman terlihat sama dari atas. Halaman di browser mengirim pesan pengguna ke endpoint Anda sendiri. Server Anda menambahkan prompt sistem, memangkas riwayat, melampirkan kunci API, dan meneruskan panggilan. Balasan mengalir kembali dengan cara yang sama.
Browser --POST /api/chat--> Your server --POST /v1/chat/completions--> Chat API
Browser <--SSE stream------ Your server <--SSE stream----------------- Chat API
Proxy ada karena empat alasan: menyembunyikan kunci, memungkinkan Anda memeriksa siapa yang memanggil, memungkinkan Anda membatasi biaya per pengguna, dan memberi Anda satu tempat untuk mengubah pengaturan model nanti. Kunci yang ditempatkan di JavaScript front-end bersifat publik begitu halaman dimuat, dan orang lain akan menghabiskan saldo prabayar Anda.
API mengikuti format OpenAI. Base URL adalah https://api.uncensoredchatbotapi.com/v1, modelnya adalah uncensored, dan autentikasinya adalah Authorization: Bearer YOUR_KEY. Dapatkan kunci di halaman kunci.
Langkah 1: proxy server
Server Express ini menerima percakapan, menambahkan prompt sistem, memanggil API dengan streaming, dan meneruskan teks. Instal dependensi dengan npm i express openai dan atur CHAT_API_KEY di lingkungan.
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);
Perhatikan filternya. Klien dapat mengirim apa saja, jadi server hanya menyimpan pesan user dan assistant, memangkas masing-masing, dan mengabaikan pesan system apa pun yang dicoba disuntikkan browser. Prompt sistem selalu berasal dari kode Anda.
Langkah 2: sisi browser
Browser membaca stream dengan fetch dan menambahkan teks saat tiba. Tidak diperlukan perpustakaan.
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 });
}
Buffer itu penting. Chunk jaringan tidak sejajar dengan batas peristiwa, sehingga Anda memisahkan pada baris kosong dan menyimpan ekor yang belum selesai untuk pembacaan berikutnya. Untuk panduan halaman itu sendiri, lihat tutorial obrolan web, dan untuk gambaran lebih luas tentang menambahkan bot ke situs, cara mengimplementasikan chatbot di situs web.
Batas, error, dan retry
Kunci penuh mengizinkan 8 permintaan paralel dan 300 per menit. Kunci uji coba mengizinkan 2 dan 60. Permintaan streaming menempati slotnya hingga streaming berakhir, jadi dengan 8 slot Anda dapat melayani paling banyak 8 balasan langsung sekaligus. Jika situs Anda memiliki lebih banyak pengguna simultan daripada itu, antrikan permintaan di server Anda dan jawab "sebentar" daripada gagal.
- 429 dengan
concurrency: terlalu banyak permintaan yang sedang berjalan. Antri dan coba lagi. - 429 dengan
rate_limited: terlalu banyak permintaan per menit. Perlahan. - 429 dengan header
Retry-After: 5: kelebihan beban sementara. Tunggu 5 detik dan coba lagi. - 401: kunci salah atau hilang.
- Body di atas 8 MB: ditolak, jadi pangkas apa yang Anda kirim.
Tambahkan penghitung kecil di memori agar server Anda sendiri tidak pernah membuka lebih dari 8 streaming upstream:
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();
});
Daftarkan perantara ini sebelum rute obrolan. Peristiwa close terjadi saat respons berakhir atau pengguna pergi, sehingga penghitung tidak bocor.
Kendalikan biaya setiap percakapan
Harganya adalah $0,15 per 1M token input dan $0,50 per 1M token output. Karena setiap giliran mengirim ulang riwayat, batas riwayat adalah pengungkit terbesar Anda. Dengan 20 pesan terakhir sekitar 60 token masing-masing ditambah prompt sistem 100 token, permintaan membawa sekitar 1.300 token input. Balasan 150 token menambah output.
Biaya per giliran: 1.300 / 1.000.000 x $0,15 = $0,000195, ditambah 150 / 1.000.000 x $0,50 = $0,000075, jadi $0,00027. Sesi 30 giliran dengan ukuran itu memakan biaya paling banyak $0,0081, karena giliran awal lebih pendek. Batas harian per pengguna, misalnya 100 pesan, membatasi kasus terburuk Anda pada 100 x $0,00027 = $0,027 per pengguna per hari. Untuk lebih lanjut tentang penetapan harga bot situs, baca halaman tentang biaya chatbot di situs web, dan gunakan dokumentasi untuk parameter seperti max_tokens.
Siapa yang memanggil proxy Anda
Proxy melindungi kunci, tetapi juga menjadi endpoint chat gratis bagi siapa saja yang menemukan URL tersebut. Putuskan siapa yang boleh menggunakannya sebelum Anda meluncurkan.
Untuk situs publik, cookie sesi bertanda tangan yang ditetapkan saat masuk adalah jawaban yang biasa. Periksa di awal rute dan kembalikan 401 jika tidak ada. Untuk prototipe cepat, batas per-IP dengan paket seperti express-rate-limit lebih baik daripada tidak ada, meskipun jaringan bersama membuat batas IP kurang tepat. Apa pun yang Anda pilih, hitung pesan per pengguna, bukan per koneksi, dan simpan hitungan di tempat yang tidak dapat direset saat restart.
Simpan riwayat percakapan di server saat aplikasi berkembang. Mengirim seluruh riwayat dari browser pada setiap giliran mudah dibangun, tetapi pengguna dapat mengeditnya. Simpan pesan dalam basis data di bawah id percakapan, muat 20 terakhir pada setiap permintaan, dan lampirkan balasan setelah streaming berakhir. Itu juga memungkinkan pengguna menutup tab dan kembali ke obrolan yang sama.
Sebelum Anda meluncurkan
Daftar periksa singkat membuat hari peluncuran tenang.
- Kunci hanya ada di variabel lingkungan di server, dan repositori tidak memuatnya.
- Server mengabaikan pesan sistem apa pun dari klien.
- Setiap pengguna memiliki batas pesan per hari dan batas panjang pesan.
- Kesalahan menampilkan pesan ramah dan tidak pernah mencetak detail internal.
- Anda mencatat id permintaan dari header
X-Request-Iddan jumlah token, bukan teks lengkap. - Anda memantau
X-Balance-USDdan mendapatkan peringatan saat saldo kredit menipis. - Syarat Anda menyatakan audiens hanya dewasa, dan bot tidak pernah menghasilkan konten seksual yang melibatkan anak di bawah umur.
Poin terakhir ini berbagi panduan terkait keamanan chatbot dewasa. Model di balik API ini disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah, yang membuat aturan pembatasan usia dan moderasi Anda lebih penting, bukan kurang. Pengisian ulang di sini hanya menggunakan kripto (USDT pada TRC20 atau USDC pada Base), mulai dari $20 hingga $500, dan pengguna baru dapat mengklaim uji coba senilai $0,50 terlebih dahulu.
Panduan lainnya
Tanya jawab
Mengapa saya tidak bisa memanggil API langsung dari JavaScript di browser?
Karena kunci akan terlihat oleh siapa saja yang membuka tab jaringan. Proxy backend menyimpan kunci di server Anda dan memungkinkan Anda menambahkan batas per pengguna.
Apakah API mendukung streaming?
Ya. Atur stream menjadi true dan API mengirim event server-sent, dengan penggunaan di akhir. Proxy Anda dapat meneruskan event tersebut ke browser.
SDK mana yang harus saya gunakan?
SDK OpenAI atau klien HTTP apa pun berfungsi. Ubah base URL menjadi https://api.uncensoredchatbotapi.com/v1, gunakan kunci Anda, dan atur model menjadi uncensored.
Apa yang terjadi jika terlalu banyak pengguna mengobrol sekaligus?
Kunci penuh mengizinkan 8 permintaan paralel. Lewat itu, API mengembalikan 429 dengan kode concurrency, jadi antri permintaan tambahan di server Anda dan coba lagi sebentar.
Kunci Anda hanya selangkah lagi dari satu formulir
Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh proses pengaturannya.