n8n

OpenAI kimlik bilgisinin Base URL alanına https://api.kunavo.com/v1 yazılması ve /v1'in korunması, bir n8n iş akışındaki her OpenAI Chat Model'i Kunavo'ya yönlendirir; model düğümünün kendisinde uç nokta alanı yoktur.

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

Adım adım

1. /app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
2. n8n’de türü OpenAI olan bir kimlik bilgisi oluşturun. Anahtarı API Key alanına girin, Organization ID (optional) alanını boş bırakın ve Base URL varsayılanını https://api.openai.com/v1 değerinden https://api.kunavo.com/v1 olarak değiştirin. Kaydedin.
3. Bir AI Agent veya Basic LLM Chain düğümü ekleyin ve bu kimlik bilgisini kullanan bir OpenAI Chat Model alt düğümü bağlayın. Model alanında From List yerine ID seçin ve kimliği GET /v1/models içinde listelendiği biçimde yazın; örneğin claude-sonnet-5. Listeyi kullanmak da mümkündür, ancak kimliği elle girmek iş akışını daha okunaklı kılar.
4. Use Responses API ayarına karar verin: zincirinizdeki bir araç Chat Completions beklemiyorsa veya n8n yürütme günlüğünde bir chat completions isteği görmek istemiyorsanız açık bırakın.
5. Tetikleyiciye bağlamadan önce iş akışını tek satırlık bir istemle bir kez çalıştırın. 401 hatası anahtarla ilgilidir; missing_v1_prefix kodlu 404 (veya eski çalıştırmalarda <!DOCTYPE html> ile başlayan bir ileti), Base URL’de /v1 kısmının eksik olduğunu gösterir.

n8n@2.41.4 etiketindeki n8n OpenAI kimlik bilgisi kaynak kodu ile 1 Ekim 2026 tarihinde kontrol edilmiştir. Üçüncü taraf ayarları değişebilir; buradaki alan adı gördüğünüzle artık eşleşmiyorsa yetkili kaynak bu sayfa değil, ilgili sayfadır.

İstemcide hata ayıklamadan önce doğrulayın

Tek bir istek, hatanın uç noktadan mı, anahtardan mı yoksa yapılandırma dosyasından mı kaynaklandığını kesinleştirir. Bu JSON döndürürse aynı temel URL ve anahtar n8n içinde çalışır.

# 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-..."

Alana hangi model kimliği yazılmalı

Her metin modeline model kimliğiyle erişilebilir — güncel liste GET /v1/models, fiyatları içeren katalog ise modeller sayfasında. Ücretler 1 milyon token başına USD cinsindendir; giriş / çıkış.

Base URL neden kimlik bilgisinde yer alıyor?

Eski eğitimlerde uç nokta model düğümünün içinde ayarlanır. Yayımlanan kaynak kodda düğüm içindeki Base URL seçeneği 1.1 sürümünden itibaren gizlidir; bu nedenle bugün eklediğiniz bir düğümde böyle bir alan bulunmaz ve geçerli olan kimlik bilgisinin Base URL değeridir. n8n’in kendi OpenAI Chat Model belgeleri ve kimlik bilgisi sayfası bu alanı açıklamaz; kaynak kodda ise açıklaması “API için varsayılan temel URL’yi geçersiz kıl” şeklindedir. HTTP Request düğümü tamamen farklı bir yoldur: çalışır, ancak AI Agent düğümünün sizin için oluşturduğu isteği elle kurmanız gerekir.

Responses API açık mı kapalı mı?

• Açık (1.3 sürümlü düğümde varsayılan ayar) — istekler /v1/responses adresine gider. Düğümün Built-in Tools araçlarını (Web Search, File Search ve Code Interpreter) gösteren tek mod budur. Bunlar OpenAI tarafından barındırılan araçlardır; hiç kimse bunları Kunavo üzerinden test etmemiştir. Önce denemeden bunlara bağlı bir iş akışı oluşturmayın.
• Kapalı — istekler /v1/chat/completions adresine gider. Bu, en geniş desteğe sahip biçimdir ve diğer ayarda bir araç çağrısı düzgün çalışmazsa kullanılacak geri dönüş seçeneğidir.
• AI Agent’a bağladığınız araçlar, işlev tanımları olarak modele gönderilir. Bu gidiş dönüş bu kontrolün kapsamında değildi; bu nedenle aracın kullanımına güvenmeden önce bir test iş akışında tek bir araç çağrısı çalıştırın.

n8n ve OpenRouter

n8n, kendi OpenRouter kimlik bilgisiyle ayrı bir OpenRouter Chat Model düğümü sunar. Bu kimlik bilgisinde bir API Key alanı ve https://openrouter.ai/api/v1 olarak sabitlenmiş, gizli bir Base URL bulunur. Testi OpenRouter’ın kendi /key yolunu çağırır; dolayısıyla OpenRouter düğümü yalnızca OpenRouter ile konuşabilir. OpenRouter’ı kullanmak istiyorsanız, OpenRouter anahtarıyla bu düğümü kullanın; bu sayfadaki hiçbir şeye ihtiyacınız yoktur.

Kunavo dâhil diğer tüm OpenAI uyumlu uç noktalar için yukarıda açıklandığı gibi OpenAI Chat Model’i ve OpenAI kimlik bilgisinin Base URL alanını kullanın. Aralarından seçim yaparken düğüme göre değil, gerçekten farklı olan etkenlere bakın: ihtiyaç duyduğunuz modeller, nasıl ödeme yapmak istediğiniz ve n8n ile diğer araçlarınızda tek bakiye kullanmak isteyip istemediğiniz. Bu karşılaştırmada Kunavo’nun tarafı Kunavo ve OpenRouter karşılaştırmasında açıklanmıştır.

Gözetimsiz bir iş akışının faturasını sınırlandırma

• Düğümde Max Retries varsayılan olarak 2, Timeout ise 60000 ms’dir. Zaman aşımına uğrayan istek yeniden denenir ve her yeniden deneme yeni bir ücretli istektir.
• Öğe başına çalışan düğümlerde Maximum Number of Tokens ayarını kullanın; 1.000 satırlık bir döngü, tek bir çağrının maliyetini katlar.
• Her üretim iş akışı için ayrı bir Kunavo anahtarı kullanın. Böylece kullanım sayfasında hangi iş akışının ne harcadığını görebilir ve diğerlerini etkilemeden bir anahtarı iptal edebilirsiniz.

Hatalar nasıl görünür?

• “401 Missing or invalid API key” — Base URL doğrudur, ancak anahtar yanlıştır. 2.41.4’te yeniden üretildi.
• “404 <!DOCTYPE html>…”, LangChain tarafından MODEL_NOT_FOUND olarak kaydedilir — yanıltıcıdır: model sorunsuzdur, Base URL’de /v1 eksiktir ve istek web sitesine ulaşmıştır. 2.41.4’te yeniden üretildi.
• JSON biçiminde model kullanılamıyor iletisi — model kimliği GET /v1/models ile tam olarak eşleşmiyor.