TR ▾
API anahtarı al

n8n'de OpenAI Uyumlu API: Kurulum Rehberi

OpenAI uyumlu API n8n için arama yaptıysanız, kısa cevap şudur: OpenAI kimlik bilgisi alanındaki iki değeri değiştirmeniz yeterlidir; Base URL ve API anahtarı. İş akışının geri kalanı herhangi bir OpenAI düğümüyle aynı şekilde kalır.

güncellendi

API terminaline veri gönderen bağlantılı bloklarla izometrik otomasyon iş akışı

Temel noktalar

Başlamadan önce ihtiyacınız olanlar

Bir n8n örneği (bulut veya kendi kendine barındırılan) ve bu hizmetten bir API anahtarı. Henüz anahtarınız yoksa, API anahtarı sayfası sizi Google veya e-posta ve şifre ile kayıt olmaya yönlendirir. Yeni kullanıcılar, o sayfada tek tıkla 7 gün geçerli ve kart gerektirmeyen $0,50 değerinde ücretsiz deneme kredisi talep edebilir.

n8n'e üç değer girilir:

  • Temel URL: https://api.onekeyllmapi.com/v1
  • API anahtarı: Authorization: Bearer <key> olarak gönderilir; n8n bunu sizin için yapar
  • Model Kimliği: uncensored

Hizmet, /v1/chat/completions, /v1/responses ve /v1/models için OpenAI istek formatını takip eden, barındırılan ve yalnızca metin içeren bir LLM API'sidir. Herhangi bir model sağlayıcısının resmi API'si olmadığı için, n8n'in OpenAI'nin sohbet uç noktasına gönderdiği her şey bir metin isteği olduğu sürece burada çalışır.

Adım 1: Kimlik bilgisini oluşturun

n8n'de Kimlik Bilgileri'i açın, Kimlik Oluştur'i seçin ve OpenAI API'yi arayın. Bunu şu şekilde doldurun:

  1. Anahtarınızı API Anahtarı alanına yapıştırın.
  2. Kuruluş Kimliği alanını boş bırakın.
  3. Varsayılan Temel URL değerini https://api.onekeyllmapi.com/v1 ile değiştirin. Sonunda /v1'i koruyun ve /chat/completions eklemeyin.
  4. Kaydedin. n8n kaydettiğinizde küçük bir test çağrısı yapar; başarısız olursa, aşağıdaki sorun giderme bölümüne atlayın.

Her ortam için ayrı bir kimlik bilgisi tutun. Bir hazırlık ve bir production n8n çalıştırıyorsanız, harcamaları ayrı görmek ve birini diğerini etkilemeden iptal etmek için her birine kendi anahtarını verin.

Adım 2: Basit bir sohbet iş akışı oluşturun

Bağlantıyı kanıtlayan en küçük şeyden başlayın: manuel bir tetikleyici ve tek bir model çağrısı.

  1. Bir Manuel Tetikleyici düğümü ekleyin.
  2. Bir OpenAI düğümü (veya n8n sürümünüze bağlı olarak Basic LLM Chain içindeki OpenAI Chat Model alt düğümü) ekleyin ve 1. adımdaki kimlik bilgisini seçin.
  3. Model için, bir ID'yi elle girmenin bir yolunu arayın. Son n8n sürümleri, liste yanında ID ile modunu sunar. Oraya uncensored yazın. Liste boş olabilir veya yalnızca OpenAI isimlerini gösterebilir, çünkü n8n bunu kendi tarafında filtreler.
  4. Bu destek biletini iki cümleyle özetleyin gibi bir prompt ekleyin ve düğümü çalıştırın.

n8n sürümünüz bir listeden seçim yapmaya ısrar ederse, bir sonraki bölümdeki HTTP Request yaklaşımını kullanın. Tüm isteği kontrol ettiğiniz için her zaman çalışır.

HTTP Request düğümüyle API'yi çağırma

HTTP Request düğümü, bu API'yi n8n'den çağırmak için en öngörülebilir yoldur ve seed, stop, top_p ve tools dahil olmak üzere API'nin kabul ettiği tüm parametreleri açığa çıkarır. Bunu yapılandırın:

  • Yöntem: POST
  • URL: https://api.onekeyllmapi.com/v1/chat/completions
  • Kimlik Doğrulama: Generic Credential Type ile Başlık Kimlik Doğrulaması, ad Authorization, değer Bearer YOUR_KEY
  • Gövde Gönder: açık, içerik türü JSON

Body (daha önceki düğümlerden veri eklemek istiyorsanız alanı İfade olarak değiştirin):

{
  "model": "uncensored",
  "messages": [
    {"role": "system", "content": "You are a concise assistant."},
    {"role": "user", "content": "Summarize this support ticket in two sentences."}
  ],
  "temperature": 0.4
}

Yanıt metni choices[0].message.content konumundadır. Bir sonraki düğümde onu {{ $json.choices[0].message.content }} ile referans alabilirsiniz.

Aynı isteği n8n dışında test etmek için terminalde şunu çalıştırın:

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."}]}'

curl çalışıyorsa ve n8n çalışmıyorsa, sorun anahtarınızda veya bakiyenizde değil, düğüm ayarlarındadır.

Çıktıyı ayrıştıran iş akışları için JSON modu

İş akışları, bir model veriyi dostane bir metne sararsa bozulur. JSON modu, API'den geçerli bir JSON nesnesi döndürmesini ister, bunu doğrudan bir Set veya IF düğümüne aktarabilirsiniz. Gövdeye response_format ekleyin:

{
  "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."}
  ]
}

Bu işlemin güvenilir olmasını sağlayan iki alışkanlık vardır. İlk olarak, JSON kelimesini söyleyin ve istemde anahtarları adlandırın, çünkü JSON modu sözdizimini garanti eder, şemanızı değil. İkinci olarak, yanıt yine de message.content içinde bir dize olarak gelir, bu nedenle alanları okumadan önce bir Code düğümü veya JSON.parse() ile bir ifade ekleyin. OpenAI düğümünde, aynı anahtar düğüm seçenekleri altında Response Format seçeneği olarak görünür.

429 ve diğer hataların yönetimi

n8n öğeleri eşzamanlı olarak çalıştırır, bu nedenle 50 satırlık bir toplu işlem sınırlara hızla çarpabilir. Tam bir anahtar 8 eşzamanlı istek ve dakika başına 300 istek izni verir; bir deneme anahtarı 2 ve 60 izni verir. Aşıldığında API, HTTP 429 ile rate_limited (dakika başına çok fazla) veya concurrency (aynı anda çok fazla) koduyla yanıt verir. Geçici aşırı yüklenme durumunda Retry-After: 5 başlığıyla 429 alırsınız.

n8n'de pratik ayarlar:

  • Düğümü açın, Settings'e gidin, Retry On Fail'i etkinleştirin, Max Tries'i 3 veya 4 olarak ayarlayın ve Wait Between Tries'i 5000 ms olarak ayarlayın.
  • Model çağrısından önce bir Loop Over Items düğümü (toplu boyut 4 ila 6) yerleştirin, böylece 8 eşzamanlı istek sınırında kalın.
  • Düğüm Ayarlar altında, Hata Durumunda, hata çıktısıyla devam edecek şekilde ayarlanabilir, böylece tek bir kötü satır çalışmayı durdurmaz.

İki limit türü hakkında daha derin bir bakış için API dokümantasyonunu okuyun. Diğer hatalar basittir: 401, anahtarın yanlış olduğunu veya başlığın Bearer kelimesini içermediğini gösterir; 404 genellikle Base URL'de bir yazım hatası veya ekstra bir yol segmenti olduğunu gösterir.

Sorun giderme kontrol listesi

Başarısızlıkların çoğu kısa bir nedenler listesinden kaynaklanır. Servisi şüpheli hale getirmeden önce üstten alta doğru ilerleyin.

BelirtiOlası nedenDüzeltme
Kaydetme veya çalıştırma sırasında 401Yanlış anahtar veya başlık Bearer içermiyorAnahtarı tekrar yapıştırın; Header Auth'ta değer Bearer ile başlamalıdır
404Temel URL'de bir yazım hatası veya ekstra bir yol varKimlik bilgisi içinde tam olarak https://api.onekeyllmapi.com/v1 kullanın
Model bulunamadıModel ID, uncensored olarak yazılmamışKimliğe Göre seçeneğine geçin veya HTTP İsteği düğümünü kullanın
Eşzamanlılıkla 4298'den fazla eşzamanlı çalıştırma (deneme anahtarında 2 adet)Öğeler Üzerinde Döngü ile toplu işlem yapın ve yeniden denemeler ekleyin
Aşağı akışta JSON ayrıştırma hatasıYanıt bir dizge veya istemde anahtarlar belirtilmemişJSON.parse() ile ayrıştırın ve anahtarları sistem isteminde açıklayın

Destek ekibiyle iletişime geçtiğinizde, başarısız olan çağrıdan X-Request-Id yanıt başlığını ekleyin. n8n'de, HTTP İsteği düğümü seçeneklerinde Yanıt Başlıklarını ve Durumunu Dahil Et seçeneğini açarak başlıkları görebilirsiniz.

Az harcama yaparak test etme

Yapıyı oluştururken deneme kredisi kullanın. Dakikada 2 eşzamanlı istek ve 60 istekle bir deneme anahtarı toplu işler için yavaştır, ancak bir kimlik bilgisi, bir istem ve ayrıştırma mantığını kontrol etmek için yeterlidir. İş akışını bir zamanlayıcıya taşıdığınızda tam anahtara geçin.

Maliyet ve mantıklı iş akışı tasarımı

Fiyatlandırma kullandıkça öde şeklindedir: ön ödemeli krediden 1M giriş tokenı başına $0,15 ve 1M çıkış tokenı başına $0,50. Günde 1.000 e-postayı sınıflandıran ve her biri için 600 giriş ve 100 çıkış tokenı kullanan bir iş akışı, 0.6M giriş tokenı ($0,09) ve 0.1M çıkış tokenı ($0,05) kullanır; bu da günde yaklaşık $0,14 eder. Başarısız veya reddedilen istekler için ücret alınmaz, bu nedenle hatalar üzerine yeniden denemeler faturayı iki katına çıkarmaz. Ayrıntılar fiyatlandırma sayfasında yer almaktadır.

İstemleri kısa tutun, modele yalnızca ihtiyaç duyduğu alanları gönderin ve yanıt kısa olduğunda max_tokens değerini ayarlayın. Kendi makinenizde de modeller çalıştırıyorsanız, bir OpenAI tarzı API aracılığıyla yerel LLM kullanma makalesine bakın; bu makale aynı istemci ayarlarını kullanır.

Sorular ve cevaplar

Özel bir temel URL ile hangi n8n düğümleri çalışır?

OpenAI kimlik bilgisi kullanan herhangi bir düğüm bunu kullanabilir, çünkü Temel URL alanı kimliğe aittir. İhtiyacınız olan bir parametreyi sunan bir düğüm yoksa, HTTP İsteği düğümünü kullanın.

n8n'de model listesi neden boş veya yanlış?

n8n listeyi kendi tarafında yükler ve filtreler. Model ID'sini elle girin veya modelin yalnızca gövde içinde bir alan olduğu HTTP Request düğümünü kullanın.

n8n'de akış kullanabilir miyim?

API, SSE üzerinden akış destekler, ancak çoğu n8n düğümü verileri ilerletmeden önce tam yanıtı bekler. İş akışları için normal, akışsız bir çağrı daha basittir.

İş akışından bakiyemi nasıl kontrol ederim?

GET /v1/balance çağrısı yapın veya herhangi bir yanıtta X-Balance-USD başlığını okuyun ve eşik altına düştüğünde sizi uyaran bir IF düğümü ekleyin.

Anahtarınız tek bir formun uzağında

Bir hesap oluşturun, anahtarı kopyalayın ve base URL'yi değiştirin. Kurulum bu kadar.