n8n'de OpenAI Node'u Nasıl Kullanılır?

n8n'de OpenAI node'u, OpenAI modelleriyle metin yazdırmayı, görsel oluşturmayı ve ses kaydını yazıya dökmeyi bir otomasyonun adımı hâline getirir. Model, OpenAI'ın metin, görsel ya da ses üreten yapay zekâ programıdır. Workflow, n8n'de bir işi otomatik yapan adımların bütünüdür. Node ise workflow'un adımlarından biridir. n8n editörü, workflow'ların kurulup düzenlendiği ekrandır. Editörün ortasındaki canvas, node'ların eklenip birbirine bağlandığı çalışma alanıdır ve her node burada bir kutu olarak görünür. Workflow'un ilk node'u olan trigger node, workflow'u belirli bir olayda ya da zamanda başlatır.

n8n'de OpenAI node'u ne yapar?

Belgelere göre OpenAI node'u, OpenAI'daki işleri otomatikleştirmek ve OpenAI'ı başka uygulamalara bağlamak için kullanılır. Node'un ayarlarında önce Resource alanından bir kaynak, sonra Operation alanından o kaynağın bir işlemi seçilir. Node'un kaynakları Text (metin), Image (görsel), Audio (ses), File (dosya), Video ve Conversation (sohbet) adlarını taşır. Bazı işlemler şunlardır:

Belgelere göre node'un ikinci sürümü (V2), n8n 1.117.0 sürümünden itibaren kullanılabilir. Node'un V2 sürümünde eski Message a Model işleminin adı Generate a Chat Completion oldu.

Örnek: Bir içerik üreticisi, her yeni video fikrini OpenAI node'una gönderen bir workflow kurar. Generate a Chat Completion işlemi her fikir için bir başlık ve kısa bir açıklama taslağı yazar.

Temel n8n kavramları n8n nedir yazısında anlatılır. Yapay zekâ ajanı kurmanın adımları n8n'de yapay zekâ ajanı nasıl kurulur yazısındadır.

n8n OpenAI'a nasıl bağlanır?

Credential, n8n'in bir hizmete bağlanmak için gereken giriş bilgisini sakladığı kayıttır. API, bir yazılımın başka bir yazılıma istek gönderip cevap alabildiği arayüzdür. API anahtarı, bir hizmetin kullanıcıya verdiği ve isteği kimin gönderdiğini gösteren gizli koddur. Belgelere göre OpenAI credential'ı API anahtarıyla kurulur.

API anahtarı, OpenAI hesabından alınır. Adımlar şunlardır:

1. OpenAI hesabına giriş yap ya da yeni bir hesap aç.
2. OpenAI'ın API keys sayfasını (platform.openai.com/api-keys) aç.
3. "Create new secret key" düğmesine tıkla, istersen anahtara bir ad ver ve oluşan anahtarı kopyala.

Anahtar n8n'e şu adımlarla eklenir:

1. Workflow boşsa "Add first step" düğmesine tıkla ve bir trigger node seç. Seçtiğin trigger node canvas'a eklenir.
2. Canvas'taki bir node'un sağındaki "Add node" (+) düğmesine tıkla. n8n, node'ları arayıp seçebildiğin node panelini (nodes panel) açar.
3. Arama kutusuna "OpenAI" yaz, OpenAI'ı ve ardından bir işlemi seç. n8n node'u canvas'a ekler ve ayarlarını açar.
4. Credential to connect with alanında "Create new credential" seçeneğini seç. Credential penceresi açılır.
5. Kopyaladığın anahtarı API Key alanına yapıştır.
6. "Save" düğmesine tıkla ve credential penceresini kapat. Yeni credential, node'un Credential to connect with alanında seçili görünür.

Belgelere göre n8n, credential'ı kaydederken bağlantıyı test eder. Organization ID alanı sadece birden çok kuruluşa (organization) üye olan OpenAI hesaplarında doldurulur. Bu kimlik OpenAI'ın Organization Settings sayfasında yer alır.

Örnek: Bir içerik üreticisi, video fikirlerini OpenAI'a yazdırmak için hesabından bir API anahtarı alır ve n8n'de OpenAI credential'ı olarak kaydeder. Sonraki her OpenAI node'unda aynı credential'ı Credential to connect with alanından seçer.

n8n Cloud, n8n şirketinin işlettiği sunucularda çalışan ve tarayıcıdan kullanılan sürümdür. Gateway credits, n8n Cloud'da OpenAI API anahtarı yerine kullanılabilen kredilerdir. Belgelere göre Credential to connect with alanında Use Gateway credits seçilirse OpenAI node'u bir OpenAI hesabı olmadan çalışır.

Örnek: Bir kişi n8n Cloud'da OpenAI node'unu ekler ve Credential to connect with alanında Use Gateway credits seçeneğini seçer. Node, kişinin bir OpenAI hesabı olmadan ilk cevabını üretir.

n8n ile OpenAI'a nasıl metin yazdırılır?

Prompt, modele ne yapacağını anlatan metindir. Generate a Chat Completion işleminin adımları şunlardır:

1. OpenAI node'unun ayarlarında Resource alanında Text, Operation alanında Generate a Chat Completion seç.
2. Model listesinden bir model seç.
3. Messages bölümündeki Text alanına prompt'u yaz ve Role alanında User seç.
4. Node'daki "Execute step" düğmesine tıkla. Modelin cevabı node'un OUTPUT bölümünde görünür.

Belgeler, hangi modelin seçileceğinden emin olmayan kullanıcıya daha nitelikli cevaplar için gpt-4o, en yüksek hız ve en düşük maliyet için gpt-4o-mini modelini önerir. Role alanının üç seçeneği şunlardır:

Belgelere göre System mesajındaki talimatlar, User mesajına yazılan talimatlardan daha etkilidir. Options bölümündeki Output Randomness (Temperature) seçeneği cevabın ne kadar değişken olacağını belirler. Belgeler 0.7 civarında başlamayı önerir. Cevaplar fazla tekrarlıysa değer artırılır, konudan sapıyorsa düşürülür.

Örnek: Bir kişi System mesajına "Cevapları sade Türkçeyle ve madde madde yaz" talimatını ekler. User mesajına bir video konusunu yazar. Model, konu için madde madde bir senaryo planı döndürür.

Belgelere göre Generate a Model Response işlemi OpenAI'ın Responses API'sini kullanır. Bu işlemde modele metin, görsel ya da PDF dosyası gönderilebilir. MCP (Model Context Protocol), yapay zekâ uygulamalarını dış araçlara bağlayan açık bir standarttır. İşlemin yerleşik araçları (Built-in Tools) şunlardır:

Örnek: Bir içerik üreticisi eski video senaryolarını yükler ve File Search aracıyla bir konuyu hangi videoda anlattığını sorar. Model, senaryolar arasında arama yapar ve ilgili videoyu bulur.

Örnek: Bir içerik üreticisi video izlenme verilerini bir dosyaya koyar ve Code Interpreter aracıyla hangi başlıkların öne çıktığını hesaplatır.

Örnek: Bir içerik üreticisi, not uygulamasının MCP sunucusuna MCP Servers aracıyla bağlanır ve modele eski fikirlerini okutur.

Örnek: Bir kişi Generate a Model Response işleminde Web Search aracını açar ve modelden bir konudaki son gelişmeleri anlatmasını ister. Model internette arama yapar ve cevabını bulduğu bilgilere göre yazar.

Belgelere göre Classify Text for Violations işleminin cevabındaki flagged alanı, içeriğin zararlı olabileceğini gösterir.

Örnek: Bir topluluk yöneticisi, bir formdan gelen yorumları yayımlamadan önce bu işlemden geçirir. İşaretlenen yorumlar ayrı bir onay listesine düşer.

n8n ile OpenAI'da görsel nasıl oluşturulur?

Generate an Image işlemi, Prompt alanına yazılan metinden görsel oluşturur. Adımlar şunlardır:

1. OpenAI node'unun ayarlarında Resource alanında Image, Operation alanında Generate an Image seç.
2. Model listesinden görseli oluşturacak modeli seç.
3. Prompt alanına istediğin görseli anlatan metni yaz.
4. "Execute step" düğmesine tıkla. Node, görseli çıktıdaki data alanında dosya olarak döndürür.

Belgelere göre Prompt alanı dall-e-2 modelinde en çok 1000, dall-e-3 modelinde en çok 4000 karakter alır. Quality seçeneğindeki HD daha ayrıntılı görseller üretir ve sadece dall-e-3 modelinde çalışır. Respond with image URL(s) seçeneği açılırsa node, dosya yerine görselin adresini döndürür.

Örnek: Bir içerik üreticisi, her video başlığını Generate an Image işlemine prompt olarak gönderir. Node her başlık için bir kapak görseli taslağı üretir.

Analyze Image işleminde görselle ilgili soru Text Input alanına yazılır. Görsel, Input Type alanında Image URL(s) seçilirse adresiyle, Binary File(s) seçilirse önceki bir node'dan gelen dosya olarak verilir.

Edit an Image işlemi var olan görselleri Prompt alanına yazılan metne göre düzenler. Belgelere göre bu işlem dall-e-2 ve gpt-image-1 modellerini destekler. Tek seferde en çok 16 görsel verilebilir ve her görsel 50 MB'tan küçük bir png, webp ya da jpg dosyası olmalıdır.

Örnek: Bir kişi bir ürün fotoğrafını Analyze Image işlemine verir ve fotoğraftaki ürünün kısa bir açıklamasını ister. Ardından aynı fotoğrafı Edit an Image işlemine verir ve arka planın sadeleşmesini ister.

n8n ile OpenAI'da ses nasıl yazıya dökülür?

Transcribe a Recording işlemi bir ses kaydını yazıya döker. Belgelere göre OpenAI bu işlemde varsayılan olarak whisper-1 modelini kullanır ve ses dosyası en çok 25 MB olabilir. Kabul edilen biçimler flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav ve webm'dir.

Adımlar şunlardır:

1. OpenAI node'unun ayarlarında Resource alanında Audio, Operation alanında Transcribe a Recording seç.
2. Input Data Field Name alanına, ses dosyasının önceki node'un çıktısındaki adını yaz. Bu ad, önceki node'un OUTPUT bölümünde görünür. Belgelere göre varsayılan değer data'dır.
3. Node'daki "Execute step" düğmesine tıkla. Kaydın metni node'un OUTPUT bölümünde görünür.

Belgelere göre Language of the Audio File seçeneğine kaydın dili iki harfli ISO-639-1 koduyla (Türkçe için tr) yazılırsa sonuç daha doğru ve daha hızlı gelir.

Örnek: Bir içerik üreticisi, videosunun ses dosyasını Transcribe a Recording işlemine verir. Node konuşmanın metnini döndürür ve sonraki node bu metinden bir video açıklaması taslağı hazırlar.

n8n OpenAI node'unda sık görülen hatalar nasıl çözülür?

HTTP Request node'u, bir web adresine istek gönderip cevabı alan node'dur. Loop Over Items node'u, veriyi parçalara bölüp her parçayı sırayla işleyen node'dur. Wait node'u, workflow'u belirli bir süre bekleten node'dur. Belgelere göre sık görülen hatalar ve çözümleri şunlardır:

• "The service is receiving too many requests from you" hatası, OpenAI'ın istek sınırları (rate limits) aşıldığında görülür. Çözüm için veriyi Loop Over Items node'uyla küçük parçalara böl ve döngünün sonuna bir Wait node'u ekle.
• "Insufficient quota" hatası, OpenAI hesabında isteği karşılayacak kadar kredi ya da kapasite olmadığında görülür. Çözüm için OpenAI ayarlarında doğru kuruluşu ve projeyi seç, kredi ve kullanım sınırlarını kontrol et.
• "Bad request - please check your parameters" hatası, n8n OpenAI'dan gelen hata mesajını yorumlayamadığında görülür. Çözüm için aynı işlemi HTTP Request node'uyla dene. Belgelere göre bu node daha ayrıntılı bir hata mesajı gösterir.
• "Referenced node is unexecuted" hatası, önceki bir node çalışmadığı için gereken veri gelmediğinde görülür. Çözüm için workflow'u hata mesajında adı geçen node'a kadar test et.

Örnek: Bir içerik üreticisi uzun bir video fikri listesini tek seferde OpenAI node'una gönderir ve istek sınırı hatası alır. Listeyi Loop Over Items node'uyla parçalara böler ve her parçadan sonra bir Wait node'u koyar.

HTTP Request node'unun kullanımı n8n'de HTTP Request nasıl kullanılır yazısında anlatılır.

Sonraki adım

n8n'de yeni bir workflow aç ve bir OpenAI node'u ekle. Credential'ı oluştur ve Text kaynağının Generate a Chat Completion işlemini seç. System mesajına kısa bir talimat, User mesajına bir video konusu yaz. "Execute step" düğmesine tıkla ve cevabı node'un OUTPUT bölümünde oku.

Kurduğun bu workflow, tekrar eden bir yazı işini kalıcı bir sisteme dönüştürmenin ilk adımıdır.