Integrasi API AI ke Node.js Express dalam 5 Menit

Oleh Darus S Alfatah · 2025-09-07 · Tutorial · 7 menit

Integrasi API AI ke Node.js Express dalam 5 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.

Sumber & Referensi

Tentang penulis

Darus S Alfatah — Founder & Penulis

Darus S Alfatah adalah pendiri BankAI. Ia membangun dan mengoperasikan gateway API LLM yang melayani developer Indonesia, dan menulis tentang integrasi LLM, arsitektur gateway, serta cara memakai AI secara praktis dan hemat biaya. Setiap panduan diuji di lingkungan nyata — termasuk kode, konfigurasi, dan perhitungan token — sebelum diterbitkan, dan diperbarui ketika dokumentasi penyedia atau harga berubah.

Kebijakan editorial

Artikel terkait

🚀 Siap Pakai All in One API Key?

Daftar sekarang, top-up pakai QRIS, dan langsung ngoding pake ChatGPT, Claude, DeepSeek & semua AI dalam satu API Key!

🔑 DAFTAR SEKARANG · Harga