Mentor akademik yang
jujur,
bukan yang manis-manis.
SYNALUM AI Mentor memberi roadmap belajar terstruktur dan
feedback blak-blakan buat mahasiswa tech — dalam bahasa slang
Indonesia. Satu endpoint chat, satu endpoint health, tanpa
drama.
$ curl -s -X POST http://localhost:3000/api/chat \
-H "Content-Type: application/json" \
-d '{"messages":[{"role":"user",
"content":"Buatin roadmap belajar
Web Development dari nol dong"}]}'
{"reply":"Oke bestie, real talk: roadmap
Web Development dari nol, nggak usah
lebay. Ini jalurnya:\n\n1. Fondasi
(minggu 1–2): HTML, CSS, JavaScript
dasar…","model":"gemini-2.5-flash",
"demo":true}
Respons di atas ASLI dari server lokal mode demo — dipotong untuk layar. Transkrip lengkap: docs/demo/curl-transcript.md.
Status & kejujuran
Halaman ini adalah dokumentasi statis di
Cloudflare Pages. API-nya sendiri adalah server Express — Pages
tidak bisa menjalankan Express, jadi tidak ada endpoint
publik live di sini. Untuk memakai API-nya, jalankan
server sendiri (lokal atau VPS — lihat
Panduan deploy). Tanpa
GEMINI_API_KEY, server jalan
mode demo: membalas dengan balasan contoh
deterministik dan menandai "demo": true.
Catatan mentor
Kalau ada yang klaim API ini live di Pages, itu bohong. Bukti
jalan-nya ada di transkrip curl & tes otomatis repo.
Mulai cepat
Clone & install
git clone https://github.com/dezzorigin/synalum-ai-mentor.git
cd synalum-ai-mentor
npm install
Isi API key (atau jalan demo)
cp .env.example .env
# isi GEMINI_API_KEY di .env — tanpa key,
# server tetap jalan mode demo
Jalankan & cek health
npm run dev
curl -s http://localhost:3000/api/health
Referensi endpoint
Dua endpoint. Semua respons JSON. Semua error JSON — tidak ada halaman error HTML.
Validasi gagal — pesan error menjelaskan field-nya.
405
Method bukan POST ke /api/chat.
429
Rate limit terlampaui.
500
Gemini tidak bisa dihubungi.
Contoh pemakaian
Tiga cara memanggil endpoint yang sama. Pilih tab, salin, tempel, jalan.
Terminal
curl -s -X POST http://localhost:3000/api/chat \
-H "Content-Type: application/json" \
-d '{"messages":[{"role":"user","content":"Aku mager banget buat ngoding, motivasi dong"}]}'
Browser / frontend
const res = await fetch("http://localhost:3000/api/chat", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
messages: [{ role: "user", content: "Aku mager banget buat ngoding, motivasi dong" }],
}),
});
const data = await res.json();
console.log(data.reply);
Node.js 20+
// Node 20+ punya fetch bawaan — tanpa dependensi.
const res = await fetch("http://localhost:3000/api/chat", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
messages: [
{ role: "user", content: "Buatin roadmap belajar Web Development dari nol dong" },
{ role: "model", content: "Oke bestie, ini jalurnya…" },
{ role: "user", content: "Lanjut ke bagian proyeknya dong" },
],
}),
});
console.log(await res.json());
Kirim seluruh riwayat tiap permintaan — API ini
stateless, tidak menyimpan percakapan. UI chat di repo
(public/) melakukan persis itu.
Deploy server
API ini butuh server Node.js — bukan hosting statis. Jalur yang
didokumentasikan & teruji build-nya: Docker, lalu Coolify di
VPS (atau platform apa pun yang menjalankan container).
docker compose up -d --build
curl -s http://localhost:3000/api/health
Coolify (VPS)
Buat resource dari repo GitHub → isi GEMINI_API_KEY di Environment Variables → deploy. Healthcheck memakai GET /api/health. Langkah lengkap ada di docs/DEPLOY.md.
Batas & error
Stateless: riwayat chat tidak disimpan di server — kirim ulang tiap permintaan.
Rate limit in-memory: restart server menghapus hitungan. Untuk trafik ramai, pakai limiter berbasis Redis (lihat docs/DEPLOY.md).
Mode demo bukan Gemini: balasan contoh deterministik, cocok untuk tes & demo — jangan dipakai untuk menilai kualitas model.
API key: jangan pernah commit .env. Key bocor = cabut & buat baru di Google AI Studio.