n8n

Field Base URL pada kredensial OpenAI — https://api.kunavo.com/v1, tetap menyertakan /v1 — menempatkan setiap OpenAI Chat Model dalam alur kerja n8n di Kunavo; node model itu sendiri tidak memiliki field endpoint.

Credentials  →  Create credential  →  OpenAI
  API Key                      sk-kn-...
  Organization ID (optional)   leave empty
  Base URL                     https://api.kunavo.com/v1     <- keep the /v1

Workflow  →  AI Agent or Basic LLM Chain  →  Chat Model: OpenAI Chat Model
  Credential to connect with   the OpenAI credential above
  Model                        ID mode:  claude-sonnet-5
  Use Responses API            on   → POST /v1/responses
                               off  → POST /v1/chat/completions

Langkah demi langkah

1. Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
2. Di n8n, buat kredensial bertipe OpenAI. Masukkan kunci di API Key, biarkan Organization ID (optional) kosong, lalu ganti nilai default https://api.openai.com/v1 pada Base URL dengan https://api.kunavo.com/v1. Simpan.
3. Tambahkan node AI Agent atau Basic LLM Chain, lalu pasang sub-node OpenAI Chat Model dengan kredensial tersebut. Ubah kolom Model dari From List menjadi ID, lalu masukkan ID seperti yang tercantum di GET /v1/models, misalnya claude-sonnet-5 — daftar model juga dapat digunakan, tetapi ID yang diketik membuat alur kerja lebih mudah dibaca.
4. Tentukan apakah Use Responses API akan digunakan: biarkan aktif, kecuali ada alat dalam rangkaian Anda yang mengharuskan Chat Completions atau Anda ingin log eksekusi n8n menampilkan permintaan chat completions.
5. Jalankan alur kerja sekali dengan prompt satu baris sebelum menghubungkannya ke pemicu. 401 menandakan masalah pada kunci; 404 dengan kode missing_v1_prefix (atau, pada eksekusi yang lebih lama, pesan yang diawali dengan <!DOCTYPE html>) berarti Base URL kehilangan /v1-nya.

Diperiksa terhadap Sumber kredensial OpenAI n8n pada tag n8n@2.41.4 pada 1 Oktober 2026. Pengaturan pihak ketiga dapat berubah; jika nama bidang di sini tidak lagi sama dengan yang Anda lihat, halaman tersebut adalah acuan, bukan halaman ini.

Verifikasi sebelum men-debug klien

Satu permintaan menentukan apakah masalahnya ada pada endpoint, kunci, atau berkas konfigurasi. Jika ini mengembalikan JSON, base URL dan kunci yang sama berfungsi di n8n.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

ID model yang harus dimasukkan ke bidang

Setiap model teks dapat diakses melalui ID model — daftar terkininya ada di GET /v1/models, dan katalog beserta harga ada di halaman model. Tarif dalam USD per 1 juta token, input / output.

Alasan Base URL ada pada kredensial

Tutorial lama mengatur endpoint di dalam node model. Pada kode sumber yang dirilis, opsi Base URL di dalam node tersebut disembunyikan mulai node versi 1.1. Karena itu, node yang Anda tambahkan sekarang tidak memiliki kolom tersebut, dan yang berlaku adalah Base URL pada kredensial. Dokumentasi OpenAI Chat Model dan halaman kredensial n8n sendiri tidak menjelaskan kolom ini; kode sumbernya menyertakan deskripsi “Override the default base URL for the API”. Node HTTP Request adalah jalur yang sepenuhnya berbeda — node itu dapat digunakan, tetapi Anda harus menyusun sendiri permintaan yang dibuatkan untuk Anda oleh node AI Agent.

Responses API aktif atau nonaktif

• Aktif (default pada node 1.3) — permintaan dikirim ke /v1/responses. Hanya mode ini yang menampilkan Built-in Tools pada node — Web Search, File Search, dan Code Interpreter. Alat-alat tersebut dihosting OpenAI; belum ada yang mengujinya melalui Kunavo, jadi jangan membuat alur kerja yang bergantung padanya sebelum mencobanya.
• Nonaktif — permintaan dikirim ke /v1/chat/completions, bentuk yang paling luas dukungannya dan yang sebaiknya digunakan jika pemanggilan alat bermasalah pada mode lainnya.
• Alat yang Anda pasang ke AI Agent dikirim ke model sebagai definisi fungsi. Siklus permintaan dan balasan tersebut tidak termasuk dalam pemeriksaan ini, jadi jalankan satu pemanggilan alat pada alur kerja uji sebelum mengandalkannya.

n8n dan OpenRouter

n8n menyediakan node OpenRouter Chat Model terpisah dengan kredensial OpenRouter sendiri. Kredensial itu memiliki kolom API Key dan Base URL tersembunyi yang nilainya ditetapkan ke https://openrouter.ai/api/v1. Pengujiannya memanggil jalur /key milik OpenRouter sendiri, sehingga node OpenRouter hanya dapat terhubung ke OpenRouter. Jika Anda ingin menggunakan OpenRouter, gunakan node tersebut dengan kunci OpenRouter; halamannya tidak memerlukan apa pun dari halaman ini.

Untuk endpoint lain yang kompatibel dengan OpenAI, termasuk Kunavo, gunakan OpenAI Chat Model dan Base URL pada kredensial OpenAI seperti di atas. Pilih di antara keduanya berdasarkan perbedaan yang nyata — model yang Anda butuhkan, cara pembayaran yang diinginkan, dan apakah Anda menginginkan satu saldo untuk n8n dan alat lainnya — bukan berdasarkan node. Sisi Kunavo dalam perbandingan tersebut dibahas di Kunavo vs OpenRouter.

Membatasi tagihan alur kerja tanpa pengawasan

• Max Retries pada node secara default bernilai 2 dan Timeout bernilai 60000 ms. Permintaan yang mengalami timeout akan dicoba kembali, dan setiap percobaan ulang merupakan permintaan baru yang ditagihkan.
• Atur Maximum Number of Tokens pada node yang berjalan untuk setiap item — perulangan atas 1,000 baris akan mengalikan biaya satu panggilan.
• Gunakan kunci Kunavo terpisah untuk setiap alur kerja produksi agar halaman penggunaan menunjukkan alur kerja mana yang menghabiskan berapa banyak, dan agar Anda dapat mencabut satu kunci tanpa memengaruhi kunci lainnya.

Seperti apa pesan kesalahannya

• “401 Missing or invalid API key” — Base URL sudah benar, tetapi kuncinya tidak valid. Direproduksi di 2.41.4.
• “404 <!DOCTYPE html>…”, ditandai oleh LangChain sebagai MODEL_NOT_FOUND — menyesatkan: modelnya benar, tetapi Base URL tidak menyertakan /v1, sehingga permintaan diarahkan ke situs web. Direproduksi di 2.41.4.
• Pesan bahwa model tidak tersedia dalam JSON — ID model tidak sama persis dengan GET /v1/models.