Yang Anda butuhkan sebelum memulai
Instansi n8n (berbasis awan atau mandiri) dan kunci API dari layanan ini. Jika Anda belum memiliki kunci, halaman kunci API memandu Anda untuk mendaftar dengan Google atau email dan kata sandi. Pengguna baru dapat mengklaim $0,50 kredit uji coba dengan satu klik di halaman tersebut, berlaku selama 7 hari dan tanpa kartu.
Tiga nilai dimasukkan ke n8n:
- URL dasar:
https://api.onekeyllmapi.com/v1 - Kunci API: dikirim sebagai
Authorization: Bearer <key>, yang ditangani secara otomatis oleh n8n - ID Model:
uncensored
Layanan ini adalah API LLM teks-hanya yang di-hosting dan mengikuti format permintaan OpenAI untuk /v1/chat/completions, /v1/responses dan /v1/models. Ini bukan API resmi dari vendor model mana pun, jadi apa pun yang dikirim n8n ke endpoint chat OpenAI berfungsi di sini selama itu adalah permintaan teks.
Langkah 1: Buat kredensial
Di n8n, buka Credentials, pilih Create credential dan cari OpenAI API. Isi seperti ini:
- Tempel kunci Anda ke bidang API Key.
- Biarkan Organization ID kosong.
- Ganti Base URL bawaan dengan
https://api.onekeyllmapi.com/v1. Pertahankan/v1di akhir dan jangan tambahkan/chat/completions. - Simpan. n8n menjalankan panggilan uji kecil saat Anda menyimpan; jika gagal, lompat ke bagian pemecahan masalah di bawah ini.
Pertahankan satu kredensial per lingkungan. Jika Anda menjalankan n8n staging dan produksi, berikan masing-masing kunci sendiri agar Anda dapat melihat pengeluaran secara terpisah dan mencabut satu tanpa menyentuh yang lain.
Langkah 2: Bangun alur kerja obrolan sederhana
Mulailah dengan hal terkecil yang membuktikan koneksi: pemicu manual dan satu panggilan model.
- Tambahkan node Manual Trigger.
- Tambahkan node OpenAI (atau sub-node OpenAI Chat Model di dalam Basic LLM Chain, tergantung versi n8n Anda) dan pilih kredensial dari langkah 1.
- Untuk model, cari cara untuk memasukkan ID secara manual. Versi n8n terbaru menawarkan mode By ID di sebelah daftar. Ketik
uncensoreddi sana. Daftar mungkin kosong atau hanya menampilkan nama OpenAI, karena n8n memfilternya di sisinya. - Tambahkan prompt seperti Ringkas tiket dukungan ini dalam dua kalimat dan jalankan node.
Jika versi n8n Anda mengharuskan memilih dari daftar, gunakan pendekatan HTTP Request di bagian berikutnya. Itu selalu berhasil karena Anda mengendalikan seluruh permintaan.
Memanggil API dengan node HTTP Request
Node HTTP Request adalah cara paling dapat diprediksi untuk memanggil API ini dari n8n, dan itu menampilkan setiap parameter yang diterima API, termasuk seed, stop, top_p dan tools. Konfigurasikan seperti ini:
- Metode:
POST - URL:
https://api.onekeyllmapi.com/v1/chat/completions - Otentikasi: Generic Credential Type dengan Header Auth, nama
Authorization, nilaiBearer YOUR_KEY - Kirim Body: on, tipe konten JSON
Body (ubah bidang menjadi Expression jika Anda ingin menyisipkan data dari node sebelumnya):
{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Summarize this support ticket in two sentences."}
],
"temperature": 0.4
}
Teks balasan berada di choices[0].message.content. Di node berikutnya, Anda dapat merujuknya dengan {{ $json.choices[0].message.content }}.
Untuk menguji permintaan yang sama di luar n8n terlebih dahulu, jalankan ini di terminal:
curl https://api.onekeyllmapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'
Jika curl berhasil dan n8n tidak, masalahnya ada di pengaturan node, bukan di kunci atau saldo Anda.
Mode JSON untuk alur kerja yang mengurai output
Alur kerja rusak ketika model membungkus data dalam prosa yang ramah. Mode JSON meminta API untuk mengembalikan objek JSON yang valid, yang dapat Anda teruskan langsung ke node Set atau IF. Tambahkan response_format ke body:
{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "system", "content": "Reply only with a JSON object with keys sentiment and summary."},
{"role": "user", "content": "The delivery was late but support fixed it fast."}
]
}
Dua kebiasaan membuat ini andal. Pertama, sebutkan kata JSON dan nama kunci dalam prompt, karena mode JSON menjamin sintaks, bukan skema Anda. Kedua, balasan masih tiba sebagai string di message.content, jadi tambahkan node Code atau ekspresi dengan JSON.parse() sebelum Anda membaca bidang. Di node OpenAI, sakelar yang sama muncul sebagai opsi Response Format di bawah opsi node.
Menangani error 429 dan lainnya
n8n menjalankan item secara paralel, sehingga batch 50 baris dapat mencapai batas dengan cepat. Kunci penuh memungkinkan 8 permintaan konkuren dan 300 permintaan per menit; kunci uji coba memungkinkan 2 dan 60. Saat Anda melebihi, API menjawab HTTP 429 dengan kode rate_limited (terlalu banyak per menit) atau concurrency (terlalu banyak sekaligus). Saat kelebihan beban sementara, Anda mendapatkan 429 dengan header Retry-After: 5.
Pengaturan praktis di n8n:
- Buka node, buka Settings, aktifkan Retry On Fail, atur Max Tries menjadi 3 atau 4 dan Wait Between Tries menjadi 5000 ms.
- Letakkan node Loop Over Items (ukuran batch 4 hingga 6) sebelum panggilan model agar Anda tetap di bawah 8 permintaan paralel.
- Di bawah node Settings, On Error dapat diatur untuk melanjutkan dengan output error, sehingga satu baris buruk tidak menghentikan jalannya.
Untuk melihat lebih dalam mengenai dua jenis batas, baca dokumentasi API. Kesalahan lainnya sederhana: 401 berarti kunci salah atau header tidak menyertakan kata Bearer, dan 404 biasanya berarti URL dasar memiliki kesalahan ketik atau segmen path tambahan.
Daftar periksa pemecahan masalah
Kebanyakan kegagalan berasal dari daftar penyebab singkat. Lewati dari atas ke bawah sebelum Anda mencurigai layanan.
| Gejala | Penyebab yang mungkin | Perbaikan |
|---|---|---|
| 401 saat menyimpan atau menjalankan | Kunci salah, atau header tidak memiliki Bearer | Tempelkan kunci lagi; di Header Auth, nilai harus dimulai dengan Bearer |
| 404 | URL dasar memiliki kesalahan ketik atau path tambahan | Gunakan tepat https://api.onekeyllmapi.com/v1 dalam kredensial |
| Model tidak ditemukan | ID model tidak diketik sebagai uncensored | Beralih ke By ID, atau gunakan node HTTP Request |
| 429 dengan konkurensi | Lebih dari 8 permintaan paralel (2 pada kunci uji coba) | Batch dengan Loop Over Items dan tambahkan percobaan ulang |
| Kesalahan parsing JSON di bagian hilir | Balasan berupa string, atau prompt tidak menyebutkan kunci | Parse dengan JSON.parse() dan jelaskan kunci-kunci tersebut dalam prompt sistem |
Saat menghubungi dukungan, sertakan header respons X-Request-Id dari panggilan yang gagal. Di n8n, Anda dapat melihat header dengan mengaktifkan Include Response Headers and Status di opsi node HTTP Request.
Menguji tanpa mengeluarkan banyak biaya
Gunakan kredit uji coba saat Anda membangun. Pada 2 permintaan paralel dan 60 permintaan per menit, kunci uji coba lambat untuk batch, tetapi cukup untuk memeriksa kredensial, prompt, dan logika parsing. Beralihlah ke kunci penuh saat Anda memindahkan alur kerja ke penjadwalan.
Biaya dan desain alur kerja yang masuk akal
Harga bersifat bayar sesuai penggunaan: $0,15 per 1M token input dan $0,50 per 1M token output, dari kredit prabayar. Alur kerja yang mengklasifikasikan 1.000 email sehari dengan 600 token input dan 100 token output masing-masing menggunakan 0,6M token input ($0,09) dan 0,1M token output ($0,05), sekitar $0,14 per hari. Permintaan yang gagal atau ditolak tidak dikenakan biaya, sehingga percobaan ulang pada kesalahan tidak menggandakan tagihan. Detailnya ada di halaman harga.
Jaga prompt tetap singkat, kirim hanya bidang yang dibutuhkan model, dan atur max_tokens ketika Anda tahu jawabannya singkat. Jika Anda juga menjalankan model di mesin Anda sendiri, lihat artikel tentang menggunakan LLM lokal melalui API bergaya OpenAI, yang menggunakan pengaturan klien yang sama.
