Semua integrasi
Otomatisasi & workflow

n8n

Otomatisasi workflow low-code dengan node AI. Ganti Base URL kredensial OpenAI.

Base URL dan API key diambil dari dasbor RouterKu (menu Integrasi & Kunci API). Pada contoh, ganti BASE_URL_DARI_DASBOR (berakhiran /v1), HOST_DARI_DASBOR (tanpa /v1) dan qdr-... dengan nilai milikmu.

n8n adalah alat otomatisasi workflow (mirip Zapier/Make) yang bisa di-host sendiri dan punya node AI. RouterKu masuk lewat kredensial OpenAI dengan mengganti Base URL-nya — panggilan berjalan dari server n8n, jadi tak terhalang CORS.

Nilai koneksi

Base URLBASE_URL_DARI_DASBOR
API Keyqdr-... (buat di menu Kunci API)
Modelsonnet-5 / opus-5

Langkah-langkah

  1. Buat kunci RouterKu

    Buka menu Kunci API di RouterKu → Buat kunci → salin (qdr-...). Kunci hanya tampil sekali, simpan baik-baik.

  2. Buat kredensial OpenAI di n8n

    Menu Credentials → New → cari OpenAI, lalu isi:

    API Keyqdr-...
    Base URLBASE_URL_DARI_DASBOR

    Klik Save. Kolom Base URL inilah kuncinya — memang disediakan untuk layanan kompatibel-OpenAI seperti RouterKu.

  3. Pakai node OpenAI atau AI Agent

    Tambah node OpenAI (pemakaian langsung) atau AI Agent + sub-node OpenAI Chat Model (mode agen dengan tools & memory). Pilih kredensial RouterKu, set Model = sonnet-5 (ketik manual bila tak ada di dropdown).

  4. Jalankan

    Klik Test step / Execute. Balasan model muncul di output node dan bisa dipetakan ke node berikutnya ({{ $json.choices[0].message.content }}).

Alternatif: node HTTP Request (tanpa node OpenAI)

Metode POST, URL BASE_URL_DARI_DASBOR/chat/completions, Authentication Header Auth (Authorization = Bearer qdr-...), body JSON:

Body (JSON)
{
  "model": "sonnet-5",
  "messages": [
    { "role": "system", "content": "Kamu asisten yang ramah." },
    { "role": "user", "content": "Halo!" }
  ]
}

Model yang disarankan

opus-5Terkuat — penalaran mendalam untuk tugas berat, banyak tool, dan agen coding.
sonnet-5Andalan harian (default) — seimbang antara kualitas, kecepatan, dan biaya.
haiku-55Tercepat & termurah — balasan chat ringan, klasifikasi, dan boilerplate.

Tips

  • Untuk workflow agentik, pakai AI Agent + OpenAI Chat Model supaya bisa memanggil tools & memory.
  • Streaming tak diperlukan di workflow batch — n8n menunggu balasan penuh.
  • Simpan Base URL di environment variable n8n biar gampang ganti antar-lingkungan.

Kalau bermasalah

  • 401 / authentication failed / invalid_api_key — cek dulu apakah kuncinya memang mati, atau cuma tidak sampai ke permintaan. Jalankan uji mandiri di bawah: kalau balasannya 200, kunci kamu SEHAT dan masalahnya ada di konfigurasi n8n (lihat 3 poin berikutnya). Kalau bukan 200, buat kunci baru di menu Kunci API.
  • 401 padahal kunci sehat (1) — belum restart n8n. Banyak aplikasi hanya membaca file .env/variabel lingkungan saat start. Setelah mengubah kunci, tutup penuh lalu jalankan ulang n8n.
  • 401 padahal kunci sehat (2) — penulisan kunci kotor. Di file .env tulis polos tanpa kutip/spasi: ROUTERKU_API_KEY=qdr-... (bukan = "qdr-..."). Pastikan tidak ada spasi di ujung dan kunci tersalin utuh (tanpa terpotong).
  • 401 padahal kunci sehat (3) — nama variabel salah. Rujukan seperti ${ROUTERKU_API_KEY} umumnya hanya dikenali bila namanya HURUF BESAR dan variabelnya benar-benar ada; kalau tidak, teks ${...} terkirim mentah sebagai kunci → 401. Saat ragu, isi kunci qdr-... langsung untuk memastikan.
  • 402 / insufficient_balance — saldo habis. Isi lewat menu Isi Saldo.
  • 404 / model_not_found — ID model salah. Pakai persis, mis. sonnet-5 (daftar di GET /v1/models).
  • Tidak konek / timeout — pastikan Base URL berakhiran /v1 dan bisa diakses dari mesin n8n.
  • 429 / rate_limited — melewati 240 permintaan/menit atau 24 paralel. Beri jeda atau kurangi konkurensi.

Uji mandiri kunci — jalankan di terminal mesin yang sama. Ganti qdr-... dengan kuncimu:

Terminal
curl -s -o /dev/null -w "%{http_code}\n" BASE_URL_DARI_DASBOR/chat/completions \
  -H "Authorization: Bearer qdr-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"haiku-55","max_tokens":10,"messages":[{"role":"user","content":"ping"}]}'
Hasil 200 = kunci dan saldo RouterKu sehat, jadi penyebab 401 ada di konfigurasi aplikasinya (paling sering: aplikasi belum di-restart setelah kunci diubah). Hasil 401 = kunci salah/dicabut → buat ulang di menu Kunci API. Hasil 402 = saldo habis → menu Isi Saldo.

Uji endpoint dari kode (opsional)

bash
curl BASE_URL_DARI_DASBOR/chat/completions \
  -H "Authorization: Bearer qdr-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"sonnet-5","messages":[{"role":"user","content":"Halo!"}]}'

Otomatisasi & workflow lain

Siap mulai pakai AI tanpa ribet?

Daftar gratis, isi saldo mulai Rp20.000 lewat QRIS, dan langsung tancap gas di editor atau aplikasimu.