Lunos logoLunos
DokumentasiIntegrasi

Integrasi: Lunos dengan n8n

Anda dapat menghubungkan Lunos atau API lain yang kompatibel dengan OpenAI ke n8n, lalu menggabungkan langkah AI dengan banyak layanan lain di dalam satu alur kerja.

Prasyarat

  • Instance n8n (cloud atau self-hosted)
  • API key Lunos
  • ID model yang tersedia di akun Anda

Langkah konfigurasi

  1. Buat kredensial OpenAI di n8n.
    • Buka menu Credentials dari sidebar kiri.
    • Klik Create credential lalu pilih OpenAI.
    • Beri nama yang jelas, misalnya Lunos AI atau Lunos OpenAI.

Modal kredensial OpenAI di n8n

  1. Atur Base URL ke https://api.lunos.tech/v1 atau URL deployment Anda.
    • Pada form kredensial yang sama, cari field Base URL.
    • Ganti nilai default dengan endpoint Lunos.
    • Pastikan suffix /v1 tetap ada agar routing kompatibel OpenAI.
    • Jika workspace Anda memakai application ID, aktifkan Add Custom Header, isi Header Name dengan x-app-id, dan Header Value dengan app ID dari dashboard Lunos.
    • Simpan lalu uji koneksi sampai muncul status berhasil.

Kredensial OpenAI dengan Base URL ke Lunos dan tes koneksi berhasil

  1. Isi API Key dengan key Lunos Anda.
    • Salin API key dari dashboard Lunos Anda.
    • Tempel ke field API key pada kredensial n8n.
    • Simpan kredensial lalu lakukan test singkat jika tersedia.

Field API key terisi (nilai disembunyikan)

  1. Tambahkan node OpenAI Chat Model (atau OpenAI / OpenRouter) ke workflow.
    • Buka canvas workflow lalu klik Add node.
    • Cari OpenAI Chat Model atau OpenAI sesuai versi n8n Anda.
    • Pilih OpenAI atau OpenRouter jika tersedia.
    • Hubungkan node ke AI Agent, trigger chat, atau step sebelumnya.
    • Di Parameters, pilih kredensial yang dibuat dan gunakan ikon pensil di samping dropdown kredensial jika perlu mengedit.

Node AI dipilih dan terhubung di canvas workflow

  1. Atur model ke ID model target, misalnya openai/gpt-4o atau google/gemini-1.5-flash-preview.
    • Pastikan kredensial yang dipilih sudah benar.
    • Pilih From list bila tersedia dan pilih model, atau ketik model ID Lunos yang valid.
    • Jalankan node sekali dan pastikan output berhasil keluar.

Dropdown model berisi ID model Lunos termasuk Claude dan penyedia lain

Contoh alur AI Agent

Berikut contoh susunan node: trigger chat, AI Agent, OpenAI Chat Model memakai kredensial Lunos, Simple Memory, dan tool HTTP Request ke https://api.lunos.tech/v1/models dengan autentikasi header agen bisa mengecek model yang tersedia.

Routing model dinamis

Gunakan expression n8n agar model dapat dipilih per eksekusi. Cara ini membuat satu workflow tetap fleksibel untuk kebutuhan kualitas, latensi, atau biaya yang berbeda.

Catatan kompatibilitas

  • Versi n8n lama tetap bisa memakai node OpenAI dengan custom base URL.
  • Versi n8n baru biasanya menyediakan node OpenRouter khusus.
  • Dukungan tool calling dan multimodal mengikuti kemampuan model yang dipilih.

Keamanan

Simpan kredensial Lunos di penyimpanan kredensial n8n dan hindari menaruh API key di JSON workflow yang dibagikan.