ID ▾
Dapatkan kunci API

API Kompatibel OpenAI di n8n: Panduan Pengaturan

Jika Anda mencari api openai compatible n8n, jawabannya singkat: Anda hanya mengubah dua nilai dalam kredensial OpenAI, yaitu Base URL dan kunci API. Sisanya tetap sama seperti dengan node OpenAI apa pun.

Diperbarui

Alur kerja otomatis isometrik dengan blok terhubung yang mengirim data ke terminal API

Poin utama

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:

  1. Tempel kunci Anda ke bidang API Key.
  2. Biarkan Organization ID kosong.
  3. Ganti Base URL bawaan dengan https://api.onekeyllmapi.com/v1. Pertahankan /v1 di akhir dan jangan tambahkan /chat/completions.
  4. 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.

  1. Tambahkan node Manual Trigger.
  2. Tambahkan node OpenAI (atau sub-node OpenAI Chat Model di dalam Basic LLM Chain, tergantung versi n8n Anda) dan pilih kredensial dari langkah 1.
  3. Untuk model, cari cara untuk memasukkan ID secara manual. Versi n8n terbaru menawarkan mode By ID di sebelah daftar. Ketik uncensored di sana. Daftar mungkin kosong atau hanya menampilkan nama OpenAI, karena n8n memfilternya di sisinya.
  4. 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, nilai Bearer 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.

GejalaPenyebab yang mungkinPerbaikan
401 saat menyimpan atau menjalankanKunci salah, atau header tidak memiliki BearerTempelkan kunci lagi; di Header Auth, nilai harus dimulai dengan Bearer
404URL dasar memiliki kesalahan ketik atau path tambahanGunakan tepat https://api.onekeyllmapi.com/v1 dalam kredensial
Model tidak ditemukanID model tidak diketik sebagai uncensoredBeralih ke By ID, atau gunakan node HTTP Request
429 dengan konkurensiLebih dari 8 permintaan paralel (2 pada kunci uji coba)Batch dengan Loop Over Items dan tambahkan percobaan ulang
Kesalahan parsing JSON di bagian hilirBalasan berupa string, atau prompt tidak menyebutkan kunciParse 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.

Tanya jawab

Node n8n mana yang berfungsi dengan URL dasar kustom?

Node apa pun yang menggunakan kredensial OpenAI dapat menggunakannya, karena bidang URL dasar milik kredensial. Jika sebuah node tidak mengekspos parameter yang Anda butuhkan, gunakan node Permintaan HTTP.

Mengapa daftar model kosong atau salah di n8n?

n8n memuat dan memfilter daftar di sisinya. Masukkan ID model uncensored secara manual, atau gunakan node HTTP Request di mana model hanyalah bidang dalam body.

Bisakah saya menggunakan streaming di n8n?

API mendukung streaming melalui SSE, tetapi sebagian besar node n8n menunggu balasan lengkap sebelum meneruskan data ke node berikutnya. Untuk alur kerja, panggilan normal non-streaming lebih sederhana.

Bagaimana cara memeriksa saldo saya dari alur kerja?

Panggil GET /v1/balance, atau baca header X-Balance-USD pada respons apa pun, dan tambahkan node IF yang memberi peringatan kepada Anda ketika nilai turun di bawah ambang batas.

Kunci Anda hanya selangkah lagi dari satu formulir

Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh pengaturannya.