BroadRouter

n8n'de BroadNet Inference kullanımı (OpenAI kimlik bilgisi, Base URL)

Güncellendi

n8n'de API Key alanına BroadNet anahtarınızı, Base URL alanına https://inference.broadnet.ai/v1 yazarak bir OpenAI kimlik bilgisi oluşturun. OpenAI Chat Model düğümünde Model modunu From List yerine ID yapın, broadnet/glm-5.3 gibi bir BroadNet kimliği girin ve n8n'in chat completions çağırması için Use Responses API seçeneğini kapatın.

n8n bir iş akışı otomasyon aracıdır. OpenAI kimlik bilgisinde bir Base URL alanı bulunur; bu sayede OpenAI Chat Model düğümü (ve bu kimlik bilgisini kullanan diğer OpenAI düğümleri) OpenAI uyumlu herhangi bir API’yi çağırabilir. BroadNet Inference de bunlardan biridir. n8n’in kimlik bilgisi belgesinde Base URL alanı görünmediği için aşağıdaki alan adları, kaynaklarda bağlantısı verilen n8n kaynak koduyla da karşılaştırılmıştır.

Kurulum

  1. Kimlik bilgisini oluşturun. n8n’de Credentials bölümüne gidin, yeni bir OpenAI kimlik bilgisi oluşturun ve şunları doldurun:

    Alan Değer
    API Key BroadNet anahtarınız
    Organization ID (optional) boş bırakın
    Base URL https://inference.broadnet.ai/v1

    Kaydedin. n8n, kimlik bilgisini Base URL üzerindeki /models adresini çağırarak test eder.

  2. Model düğümünü ekleyin. Bir AI Agent veya Basic LLM Chain düğümü ekleyin, ardından bir OpenAI Chat Model alt düğümü bağlayıp kimlik bilgisini seçin.

  3. Modeli kimliğiyle ayarlayın. Model alanında modu From List yerine ID yapın ve broadnet/glm-5.3 girin.

  4. Use Responses API seçeneğini kapatın. n8n’in kaynak koduna göre bu anahtar düğüm sürümü 1.3’ten itibaren vardır ve orada varsayılan olarak açıktır. BroadNet chat completions sunduğu için kapatın.

  5. Seçenekleri ayarlayın. Options altında Maximum Number of Tokens değerini varsayılanında (-1) bırakın ya da birkaç bin olarak ayarlayın. Max Retries varsayılan olarak 2’dir; n8n’in başarısız çağrıları daha sık yeniden denemesini istiyorsanız artırın.

  6. İş akışını bir test istemiyle bir kez çalıştırın.

OpenAI dışı bir Base URL kullandığınızda n8n bir uyarı gösterir: “not all models might be chat-compatible or support tools calling or JSON response format” (çeviri: tüm modeller sohbet uyumlu olmayabilir ya da araç çağırmayı veya JSON yanıt biçimini desteklemeyebilir). BroadNet’te sohbet her sohbet modelinde çalışır, ancak BroadNet’in belgeleri araçları ve yapılandırılmış çıktıyı yalnızca GLM 5.3 ve Qwen3.8 27B için listeler.

Hangi modeli seçmeli

İş akışı Model Neden
Araçlı AI Agent broadnet/glm-5.3 BroadNet araçları ve yapılandırılmış çıktıyı listeliyor
Görseller, Arapça mesajlar broadnet/qwen3.8-27b Araçlar, görsel girdi, Arapçada test edildi
Yüksek hacimli sınıflandırma broadnet/gemma-4-26b-a4b Düşük token başına fiyat; akıl yürütme listelenmemiş
Uzun belgeler broadnet/deepseek-v4.1-flash 1M bağlam; araçlar listelenmemiş

Fiyatları fiyatlandırma sayfasında karşılaştırın. Ses için n8n’in HTTP Request düğümü dosyaları /v1/audio/transcriptions adresine gönderebilir; Arapça ses metne çevirme rehberi gönderilecek form alanlarını gösterir.

Sorun giderme

  • Kimlik bilgisi testi başarısız. Base URL’nin sonda başka bir yol olmadan /v1 ile bittiğini kontrol edin. Sohbet çağrıları da 401 döndürüyorsa anahtar yanlış, süresi dolmuş ya da kullandıkça öde kullanım hakkı tükenmiş demektir.
  • Model hataları. ID modunu kullanın ve BroadNet kimliğini broadnet/ önekiyle birlikte birebir girin. GLM 5.3, Qwen3.8 27B ve DeepSeek V4.1 Flash için bakiye yüklemeniz gerekir; $5 başlangıç kredisi BroadNet Gemma 4 VL 26B’yi kapsar.
  • “Bad request - please check your parameters”. n8n’in belgeleri, hatanın tamamını görmek için çağrıyı bir HTTP Request düğümünde tekrarlamayı önerir. Buradaki yaygın nedenlerden biri Responses API anahtarıdır.
  • Boş çıktı. Akıl yürütme Maximum Number of Tokens sınırına dahildir. Değeri artırın. Yanıtlar neden boş geliyor.
  • Döngülerde 429. Kullandıkça öde anahtarı dakikada 30 isteğe ve aynı anda 4 isteğe izin verir. n8n’in belgeleri, toplu işleri yavaşlatmak için Loop Over Items ile bir Wait düğümünü önerir. Hatalar ve yeniden denemeler rehberine bakın.
  • Plan anahtarında paralel çalıştırmalar. Bir sınırsız plan oturumu aynı anda tek istek çalıştırır. Her birinin kendi oturumu yoksa paralel iş akışı çalıştırmaları sıraya girer.

Kod mu tercih ediyorsunuz? Aynı ayarlar, n8n’in AI düğümlerinin üzerine kurulduğu LangChain ile de çalışır.

Sık sorulan sorular

n8n AI Agent, BroadNet ile neden hata veriyor?

OpenAI Chat Model düğümünde Use Responses API seçeneğinin kapalı olduğunu kontrol edin. Düğüm sürümü 1.3'te bu seçenek varsayılan olarak açıktır ve BroadNet, Responses API'yi değil /v1/chat/completions uç noktasını sunar. Ayrıca Model alanını ID moduna alıp BroadNet kimliğini birebir girin.

Model açılır listesi neden boş ya da yanlış?

From List modu sağlayıcının /models uç noktasını okur. BroadNet'in belgeleri bu uç noktayı izleme araçları için herkese açık katalog meta verisi olarak tanımlar. Model alanını ID moduna alın ve BroadNet model kimliğini yazın.

n8n ajanı neden boş çıktı döndürüyor?

Akıl yürütme Maximum Number of Tokens sınırını tüketmiştir. Değeri artırın ya da varsayılan -1 değerinde bırakın.

n8n'in OpenAI kimlik bilgisinde Base URL alanı nerede?

OpenAI kimlik bilgisinin kendisinde, API Key ve Organization ID alanlarının altında. Varsayılan değeri https://api.openai.com/v1'dir. Bunu https://inference.broadnet.ai/v1 ile değiştirin; /v1 kısmını koruyun ve başka bir yol eklemeyin.

Markdown olarak okuChatGPT asistanına sorClaude asistanına sorPerplexity asistanına sor