Activepieces akışlarına OpenAI uyumlu bir AI sağlayıcısı verin.

Hızlı yanıt: admin AI kurulumunda tek bir sağlayıcı girişi.

Activepieces admin konsolunda, AI setup sayfasını açın ve OpenAI Compatible türünde bir sağlayıcı ekleyin. Form; bir Display Name, bir API Key, bir Base URL, bir API Key Header, isteğe bağlı varsayılan header'lar ve her girdisinde bir Model ID, bir Model Name ve bir Model Type bulunan bir model listesi alır. APIsRouter için değerler: Base URL https://api.apisrouter.com/v1'dir (kod tabanının kendi yerleşik uyumlu sağlayıcıları için kullandığı aynı şekil), API Key Header Authorization'dır ve anahtar alanı gateway anahtarınızı alır. Bilinmeye değer bir uygulama detayı: Activepieces, anahtarı o header'a tam olarak yazdığınız gibi gönderir, otomatik olarak Bearer ön eki eklenmez, bu yüzden kurallı biçim için anahtarı "Bearer sk-..." olarak girin; APIsRouter, Authorization header'ında çıplak anahtarı da kabul eder, bu yüzden burada her iki yazım da işe yarar. Ardından akışların görmesini istediğiniz her modeli, Model ID katalogla tam olarak eşleşecek şekilde ekleyin.

Admin Console -> AI setup -> Add AI Provider
  -> OpenAI Compatible

Display Name:   APIsRouter
Base URL:       https://api.apisrouter.com/v1
API Key Header: Authorization
API Key:        Bearer sk-YOUR-APISROUTER-KEY

Models (Add Model):
  Model ID: claude-haiku-4-5-20251001  Type: TEXT
  Model ID: deepseek-v4-flash          Type: TEXT
  Model ID: claude-sonnet-4-6          Type: TEXT

Activepieces özel bir sağlayıcıyı nasıl kullanır.

Activepieces (GitHub'da yaklaşık 23K yıldız), önde gelen açık kaynaklı no-code otomasyon platformudur: tetikleyicilerden ve piece'lerden oluşturulan akışlar, Zapier şeklinde ama self-hostable, MIT lisanslı bir piece framework'ü ve büyük bir topluluk kataloğuyla. AI yetenekleri (metin üretim adımları, agent'lar, AI utility piece'leri), modellerini platformun yapılandırılmış AI sağlayıcıları üzerinden çözer; bu da sağlayıcı girişini aynı anda her akış için bir yönlendirme kararı haline getiren şeydir. Perde arkasında, OpenAI Compatible sağlayıcı, Base URL'inize karşı standart bir istemci oluşturur ve anahtarınızı seçtiğiniz header adı altına ekler, artı projeyi ve akışı tanımlayan çalıştırma başına metadata header'ları. Kaydettiğiniz Model ID, chat-completions isteklerinde model dizesi olarak iletilir. Bu sağlayıcı türü için model auto-discovery yoktur: akışlar yalnızca listeye eklediğiniz modelleri seçebilir, bu da seçiciyi kalabalık yerine amaçlı tutar. Sağlayıcı yapılandırması platform seviyesindedir. Bir admin bunu bir kez tanımlar ve örnekteki her proje ve akış, kayıtlı modellerden seçim yapar. Bu merkezileştirme yönetişim kazanımıdır: hangi modellerin var olduğuna karar vermek için tek bir yer, tüm AI adımlarını ölçmek için tek bir anahtar ve her istekteki akış başına metadata, günlükleri okuduğunuzda kullanımı isnat edilebilir kılar.

Tam kurulum ve kayıt anı uyarısı.

Form, bağlantıyı doğrulamadan kaydedilir; sağlayıcı uygulaması OpenAI Compatible türü için bağlantı kontrollerini açıkça atlar. Bu kullanışlıdır (kayıt anında endpoint'inizi yoklamaz) ama yanlış bir Base URL veya bozuk bir anahtarın, bir AI adımına dokunan ilk akış çalıştırmasında daha sonra başarısız olacağı anlamına gelir. Endpoint'i, üretim akışlarına bağlamadan önce elle bir kez doğrulayın ve ilk çalıştırmayı kurulumun bir parçası olarak ele alın. Model Type, girdiyi hangi piece'lerin kullanabileceği açısından önemlidir: metin adımları TEXT modelleri ister. Id'yi katalogda yazıldığı gibi tam olarak kaydedin; Model Name bir görüntü etiketidir ve okunabilir herhangi bir şey olabilir. Farklı ekipler için aynı temel modeli iki fiyat-performans katmanında istiyorsanız, onu Model ID başına bir kez kaydedin; görüntü adları onları seçicide ayırt edilebilir tutar.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

Otomasyon adımları için model seçmek.

Sağlayıcı platform genelinde olduğu için, model yönetişimi tek bir ekrandır: onayladığınız id'leri ekleyin, anahtar başına bir haftalık kullanımı izleyin ve kimsenin kullanmaması gerekeni budayın. Akış oluşturucular, sizin derlediğiniz liste içinde özgürlüklerini korur.

• Otomasyon AI'ı yüksek hacimli, kısa prompt'lu bir iştir: bir talebi sınıflandırın, alanları çıkarın, bir mesaj taslağı hazırlayın, bir webhook payload'unu özetleyin. claude-haiku-4-5-20251001, gpt-5.4-mini ve deepseek-v4-flash, çoğu adımı hacim fiyatlandırmasıyla kapsar.
• Yargı gerektiren adımlar için daha güçlü bir id ayırın. Müşteriye yönelik yanıtlar taslaklayan veya yönlendirme kararları alan bir akış, akış oluşturucuda adım başına seçilen claude-sonnet-4-6'yı hak eder.
• MiniMax-M2.7 ve DeepSeek ailesi, günde binlerce çalıştırmanın normal olduğu toplu dönüştürme akışları (feed'ler, scraping temizlikleri, zenginleştirme) için son derece iyi fiyatlandırılır.
• Akışlar gözetimsiz çalışır, bu yüzden maliyet bir program çarpı çalıştırma başına token sayısıdır. Kullanım günlüğü size çalıştırma başına sayıyı verir; program sizindir.
• Az sayıda modeli bilinçli olarak kaydedin. Seçici tam olarak eklediklerinizi gösterir ve derlenmiş bir liste, yüz akış oluşturucunun her birinin farklı seçim yapmasını engeller.

Kullandıkça öde · resmi fiyatların altında

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Activepieces'e özgü hata modları.

Sessiz kayıt, gürültülü ilk çalıştırma. OpenAI Compatible sağlayıcı bağlantı doğrulamasını atladığı için, her kablolama hatası (yanlış Base URL, eksik /v1, kötü anahtar, yanlış header adı) bir form hatası yerine bir akış çalıştırmasında başarısız bir AI adımı olarak ortaya çıkar. Sağlayıcı değişikliklerinden hemen sonra bir AI adımı başarısız olduğunda, akıştan önce sağlayıcı girişinden şüphelenin. Bearer ön eki sorusu. Anahtar, seçtiğiniz header altında olduğu gibi gönderilir. Literal Bearer ön ekini gerektiren endpoint'ler, bunun anahtar alanına yazılmasını ister; APIsRouter her iki biçimi de kabul eder, ama bu sağlayıcıyı bir gün başka bir yere yeniden yönlendirirseniz, platformun sizin için ön eki eklemeyeceğini unutmayın. Model ID'leri kesindir. Yazım hatası olan kayıtlı bir id formdan geçer (etiketler serbest metindir) ve çalışma zamanında model-not-found ile başarısız olur; gateway'in /v1/models çıktısı yetkili yazımdır. Auto-discovery olmaması bir hata değil bir özelliktir. Bir model bir akışın seçicisinde eksikse, sağlayıcıda kayıtlı değildir; akış oluşturucuda aramak yerine admin konsolunda ekleyin. Ve piece seviyesindeki bağlantıları kafanızda ayrı tutun: OpenAI piece'i gibi bireysel piece'ler, bağlantı başına kendi kimlik bilgilerini tutabilir, burada açıklanan sağlayıcı girişi ise platformun evrensel AI yeteneklerini besler. Bir akış, kendi bağlantısı olan bir satıcıya özgü piece kullanıyorsa, o trafik gateway girişiniz üzerinden yönlendirilmez.

Activepieces'i bir gateway üzerinden kim yönlendirir.

• Onlarca akışta AI'ı standartlaştıran self-hosting ekipleri; burada tek bir sağlayıcı girişi ve tek bir anahtar, piece başına dağınık kimlik bilgilerinin yerini alır.
• Model yönetişimi isteyen platform adminleri: derlenmiş bir model listesi, anahtar başına kullanım ve akışlara dokunmadan arka uç endpoint'i değiştirebilme yeteneği.
• Tek bir örnekte müşteri otomasyonlarını çalıştıran, aynı katalogda ayrı anahtarlarla müşteri başına AI kullanımını ölçen ajanslar.
• Akışları hacim adımlarını ve yargı adımlarını karıştıran oluşturucular, adım başına tek bir endpoint üzerinden hızlı id'leri sınır id'lerle eşleştirir.
• Belirli bir satıcının faturalandırmasına erişimi olmayan geliştiriciler. Kart gerektirmeyen yükleme tabanlı erişim, sağlayıcı başına kayıt bağımlılığını ortadan kaldırır.

Endpoint'i doğrulayın ve ilk AI adımını hata ayıklayın.

Sağlayıcıyı kaydetmeden önce yukarıdaki iki curl'ü çalıştırın; bunlar anahtarı, Base URL'yi ve model id'sini birlikte kanıtlar, ki bu tam olarak formun sizin için kontrol etmeyeceği şeydir. Kurulumdan sonra bir akışın AI adımı başarısız olduğunda, adım hatasını okuyun. Kimlik doğrulama hataları, anahtar alanının veya header adının yanlış olduğu anlamına gelir (veya bunu gerektiren bir endpoint'te Bearer ön eki eksiktir). Model-not-found hatası, katalogla eşleşmeyen kayıtlı bir id'dir. Bir bağlantı hatası genellikle Base URL'nin /v1'ini kaybettiği anlamına gelir. Adım seçilecek hiçbir model bulamıyorsa, sağlayıcı kaydedilmiştir ama o model türü için model listesi boştur. Akışlar çalıştıktan sonra, APIsRouter konsolu istek başına modeli, token sayılarını ve harcamayı gösterir. Zamanlanmış otomasyonlar sessizce katlanır ve anahtar başına kullanım görünümü, bir platform adminin fatura gelmeden hangi akışların token'larını hak ettiğini görme şeklidir.

Sık sorulan sorular