Integrasi API AI ke Node.js Express dalam 5 Menit
Oleh Darus S Alfatah · 2025-09-07 · Tutorial · 7 menit
Catatan penulis: Jangan pernah mengirim kunci ke browser. Di Express, semua panggilan AI lewat server.
Fokus artikel ini
Artikel ini khusus Node.js + Express: route, streaming, dan penanganan error. Untuk framework web lain, lihat artikel terkait.
Baca juga: Integrasi API AI ke Laravel: Panduan Lengkap untuk Developer · Integrasi API AI ke Next.js (App Router) untuk Aplikasi Web
Pendahuluan: AI di Backend Node.js
Node.js dan Express adalah pilihan favorit untuk membangun API backend di Indonesia — cepat, ringan, dan ekosistem npm-nya sangat luas. Menambahkan kemampuan AI ke backend Node.js kini sangat mudah berkat OpenAI SDK yang juga didukung penuh oleh All in One API Key BankAI.
Dalam artikel ini, Anda akan belajar mengintegrasikan API AI ke endpoint Express hanya dalam 5 menit.
Langkah 1: Setup Proyek
mkdir ai-backend && cd ai-backend
npm init -y
npm install express openai dotenv
Langkah 2: Buat File .env
OPENAI_API_KEY=sk-bankai-xxxxxxxx
OPENAI_BASE_URL=https://bankai.web.id/api
PORT=3000
Langkah 3: Buat Endpoint AI
require('dotenv').config();
const express = require('express');
const OpenAI = require('openai');
const app = express();
app.use(express.json());
const client = new OpenAI({
baseURL: process.env.OPENAI_BASE_URL,
apiKey: process.env.OPENAI_API_KEY
});
app.post('/api/ai', async (req, res) => {
try {
const completion = await client.chat.completions.create({
model: 'auto',
messages: [
{ role: 'system', content: 'Kamu asisten AI backend.' },
{ role: 'user', content: req.body.prompt }
]
});
res.json({ reply: completion.choices[0].message.content });
} catch (err) {
res.status(500).json({ error: err.message });
}
});
app.listen(process.env.PORT || 3000, () => {
console.log('AI backend berjalan di port 3000');
});
Langkah 4: Test Endpoint
curl -X POST http://localhost:3000/api/ai -H "Content-Type: application/json" -d '{"prompt":"Buatkan ide nama startup AI"}'
Tips Produksi
- Gunakan streaming untuk respons panjang agar user tidak menunggu lama.
- Pasang rate limit di level aplikasi untuk mencegah abuse.
- Jangan hardcode API key — selalu pakai environment variable.
- Tangani timeout untuk model reasoning yang lambat.
Dengan All in One API Key BankAI, backend Node.js Anda langsung punya akses ke 10+ model AI tanpa biaya setup mahal. Mulai dari Rp 2.000!
Membuat Endpoint Proxy yang Aman
Pola yang paling sering dipakai: frontend memanggil endpoint milik Anda, lalu server Express yang memanggil API model dengan kunci rahasia. Dengan begitu kunci tidak pernah sampai ke browser. Endpoint ini sebaiknya juga memeriksa sesi pengguna, membatasi panjang input, dan mencatat pemakaian token agar biaya bisa dilacak per pengguna.
app.post('/api/chat', requireSession, async (req, res) => {
const { messages } = req.body;
if (!Array.isArray(messages) || messages.length > 30) {
return res.status(400).json({ error: 'Payload tidak valid' });
}
try {
const r = await client.chat.completions.create({
model: 'auto',
messages,
max_tokens: 800
});
res.json({ reply: r.choices[0].message.content });
} catch (e) {
res.status(502).json({ error: 'Gagal memanggil model' });
}
});
Rate Limit dan Antrian
Tanpa pembatas, satu pengguna bisa menghabiskan kuota seluruh tim. Gunakan middleware rate limit sederhana per IP atau per akun, lalu tambahkan antrian untuk permintaan berat agar server tidak kehabisan koneksi. Untuk trafik tinggi, pisahkan proses pemanggilan model ke worker terpisah supaya event loop Express tetap responsif.
Logging yang Berguna
Catat durasi, model, jumlah token, dan status untuk setiap permintaan. Jangan mencatat isi percakapan penuh kecuali benar-benar diperlukan, dan jika dicatat, beri masa retensi pendek serta redaksi data pribadi.
Checklist Sebelum Deploy
Sebelum aplikasi Express dibuka ke publik, pastikan enam hal ini sudah beres. Pertama, kunci API hanya ada di environment server, tidak pernah di kode frontend maupun repositori. Kedua, ada validasi panjang dan struktur pesan agar pengguna tidak mengirim payload raksasa yang menghabiskan kuota dalam satu permintaan. Ketiga, setiap endpoint yang memanggil model dilindungi pemeriksaan sesi atau token, bukan terbuka bebas.
Keempat, tersedia batas waktu yang wajar, misalnya enam puluh detik, agar koneksi menggantung tidak menumpuk. Kelima, kegagalan dari penyedia model ditangkap dan diterjemahkan menjadi pesan yang ramah pengguna, bukan jejak teknis yang membocorkan detail sistem. Keenam, pemakaian token tercatat per pengguna sehingga Anda bisa memutuskan kapan perlu menerapkan kuota.
Setelah rilis, pantau dua metrik sederhana setiap hari: jumlah permintaan gagal dan biaya token rata-rata per pengguna aktif. Keduanya adalah indikator paling awal bahwa ada penyalahgunaan atau kesalahan desain prompt.
Abstraksi Klien yang Mudah Diganti
// ai.js
export async function chat(messages, opts = {}) {
const r = await fetch(process.env.AI_BASE + '/v1/chat/completions', {
method: 'POST',
headers: { 'Content-Type': 'application/json',
Authorization: 'Bearer ' + process.env.AI_KEY },
body: JSON.stringify({ model: opts.model || 'auto', messages,
max_tokens: opts.maxTokens || 700 })
});
if (!r.ok) throw new Error('upstream ' + r.status);
return (await r.json()).choices[0].message.content;
}
Menyiapkan Health Check
Tambahkan endpoint yang menguji koneksi ke penyedia model secara ringan. Tampilkan status di dashboard internal agar tim tahu lebih awal ketika penyedia bermasalah, sebelum pengguna melapor.
Menutup Kebocoran Kunci
Periksa log dan pesan error agar tidak memuat header Authorization. Banyak insiden kebocoran terjadi karena error mentah dikirim ke klien atau dicatat apa adanya.
Contoh route server: Endpoint POST /chat menerima pesan, membaca kunci dari process.env, memanggil gateway, lalu mengembalikan hasil. Kunci tidak pernah sampai ke klien.
Pertanyaan yang Sering Diajukan
Apakah tutorial ini bisa diikuti pemula?
Ya. Langkah-langkahnya dijelaskan berurutan dan menyertakan contoh kode, jadi bisa diikuti pemula maupun developer berpengalaman.
Apakah endpoint BankAI kompatibel dengan library yang sudah saya pakai?
Ya, BankAI 100% kompatibel dengan standar OpenAI, sehingga library seperti OpenAI SDK, LangChain, dan tools sejenis bisa dipakai tanpa mengubah kode selain Base URL dan API key.
Di mana saya mendapatkan API key untuk mengikuti tutorial ini?
API key (dan Secret Token) didapat setelah daftar dan menyelesaikan pembayaran di dashboard BankAI.