Beri flow Activepieces provider AI OpenAI-compatible.

Jawaban singkat: satu entri provider di admin AI setup.

Di admin console Activepieces, buka halaman AI setup dan tambahkan provider bertipe OpenAI Compatible. Form-nya meminta Display Name, API Key, Base URL, API Key Header, header default opsional, dan daftar model di mana setiap entri punya Model ID, Model Name, dan Model Type. Nilai untuk APIsRouter: Base URL adalah https://api.apisrouter.com/v1 (bentuk yang sama dipakai codebase-nya sendiri untuk provider compatible bawaan), API Key Header adalah Authorization, dan field key menerima key gateway Anda. Satu detail implementasi yang perlu diketahui: Activepieces mengirim key di header itu persis seperti yang Anda ketik, tanpa prefix Bearer ditambahkan otomatis, jadi masukkan sebagai "Bearer sk-..." untuk bentuk kanonik; APIsRouter juga menerima key polos di header Authorization, jadi kedua ejaan berfungsi di sini. Lalu tambahkan setiap model yang ingin dilihat flow, dengan Model ID cocok persis dengan katalog.

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

Bagaimana Activepieces menggunakan provider custom.

Activepieces (sekitar 23K bintang di GitHub) adalah platform otomasi no-code open-source terkemuka: flow dibangun dari trigger dan piece, dalam bentuk Zapier tapi bisa self-hosted, dengan framework piece berlisensi MIT dan katalog komunitas yang besar. Kapabilitas AI-nya (step generasi teks, agent, piece utilitas AI) me-resolve model-nya lewat provider AI platform yang dikonfigurasi, itulah yang membuat entri provider menjadi keputusan routing untuk setiap flow sekaligus. Di baliknya, provider OpenAI Compatible membangun client standar terhadap Base URL Anda dan melampirkan key Anda di bawah nama header yang Anda pilih, plus header metadata per-run yang mengidentifikasi project dan flow. Model ID yang Anda daftarkan diteruskan sebagai string model pada request chat-completions. Tidak ada auto-discovery model untuk tipe provider ini: flow hanya bisa memilih persis model yang Anda tambahkan ke daftar, yang membuat picker tetap terarah alih-alih dibanjiri. Konfigurasi provider bersifat platform-level. Admin mendefinisikannya sekali, dan setiap project serta flow di instance memilih dari model yang terdaftar. Sentralisasi itulah kemenangan governance-nya: satu tempat untuk memutuskan model apa yang ada, satu key untuk memeteri semua AI step, dan metadata per-flow di setiap request membuat penggunaan bisa diatribusikan saat Anda membaca log.

Setup lengkap dan catatan soal waktu simpan.

Form ini tersimpan tanpa memvalidasi koneksi; implementasi provider secara eksplisit melewati pengecekan koneksi untuk tipe OpenAI Compatible. Itu nyaman (tidak ada probing endpoint Anda saat disimpan) tapi berarti Base URL yang salah atau key yang cacat baru gagal belakangan, pada AI step pertama yang dijalankan flow. Verifikasi endpoint secara manual sekali sebelum menghubungkannya ke flow produksi, dan perlakukan run pertama sebagai bagian dari setup. Model Type penting untuk menentukan piece mana yang bisa memakai entri: step teks menginginkan model TEXT. Daftarkan id persis seperti ejaan katalog; Model Name adalah label tampilan dan bisa apa saja yang mudah dibaca. Jika Anda ingin model dasar yang sama di dua tier harga-performa untuk tim berbeda, daftarkan sekali per Model ID; nama tampilan menjaganya tetap terbedakan di picker.

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

Memilih model untuk step otomasi.

Karena provider bersifat platform-wide, governance model adalah satu layar: tambahkan id yang Anda restui, amati penggunaan seminggu per key, dan pangkas apa yang tidak seharusnya dipakai siapa pun. Flow builder tetap punya kebebasan di dalam daftar yang Anda kurasi.

• AI otomasi adalah kerja volume tinggi, prompt pendek: klasifikasikan tiket, ekstrak field, susun pesan, ringkas payload webhook. claude-haiku-4-5-20251001, gpt-5.4-mini, dan deepseek-v4-flash mencakup sebagian besar step dengan harga volume.
• Cadangkan id yang lebih kuat untuk step yang butuh penilaian. Flow yang menyusun balasan yang dilihat customer atau membuat keputusan routing pantas mendapat claude-sonnet-4-6, dipilih per step di flow builder.
• MiniMax-M2.7 dan keluarga DeepSeek diberi harga sangat baik untuk flow transformasi massal (feed, pembersihan scraping, enrichment) di mana ribuan run per hari adalah hal normal.
• Flow berjalan tanpa pengawasan, jadi biaya adalah jadwal dikalikan jumlah token per run. Log penggunaan memberi Anda angka per run; jadwalnya milik Anda.
• Daftarkan sedikit model secara sengaja. Picker menampilkan persis apa yang Anda tambahkan, dan daftar terkurasi mencegah seratus flow builder masing-masing memilih berbeda.

Bayar sesuai pemakaian · di bawah harga resmi

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

Mode kegagalan spesifik Activepieces.

Simpan diam, run pertama berisik. Karena provider OpenAI Compatible melewati validasi koneksi, setiap kesalahan pengkabelan (Base URL salah, /v1 hilang, key buruk, nama header salah) muncul sebagai AI step yang gagal di run flow alih-alih error form. Saat AI step gagal tepat setelah perubahan provider, curigai entri provider sebelum flow-nya. Pertanyaan prefix Bearer. Key dikirim apa adanya di bawah header pilihan Anda. Endpoint yang mensyaratkan prefix Bearer literal butuh itu diketik ke field key; APIsRouter menerima kedua bentuk, tapi jika Anda pernah mengarahkan ulang provider ini ke tempat lain, ingat platform-nya tidak akan menambahkan prefix untuk Anda. Model ID bersifat persis. Id terdaftar dengan salah ketik lolos form (label adalah teks bebas) dan gagal saat runtime dengan model-not-found; output /v1/models gateway adalah ejaan otoritatif. Tanpa auto-discovery adalah fitur, bukan bug. Jika model hilang dari picker flow, berarti belum didaftarkan di provider; tambahkan di admin console alih-alih mencarinya di flow builder. Dan simpan koneksi level-piece secara terpisah di kepala Anda: piece individual seperti piece OpenAI bisa menyimpan kredensial sendiri per koneksi, sementara entri provider yang dijelaskan di sini menyalakan kapabilitas AI universal platform. Jika flow memakai piece khusus vendor dengan koneksinya sendiri, traffic itu tidak merutekan melalui entri gateway Anda.

Siapa yang merutekan Activepieces melalui gateway.

• Tim self-hosting yang menstandarkan AI di puluhan flow, di mana satu entri provider dan satu key menggantikan kredensial per-piece yang berserakan.
• Admin platform yang menginginkan governance model: daftar model terkurasi, penggunaan per-key, dan kemampuan menukar endpoint backing tanpa menyentuh flow.
• Agency yang menjalankan otomasi klien di satu instance, memeteri penggunaan AI per klien dengan key terpisah pada katalog yang sama.
• Builder yang flow-nya mencampur step volume dan step penilaian, memasangkan id cepat dengan id frontier per step melalui satu endpoint.
• Developer tanpa akses ke billing vendor tertentu. Akses berbasis top-up tanpa syarat kartu menghilangkan ketergantungan sign-up per provider.

Verifikasi endpoint dan debug AI step pertama.

Jalankan dua curl di atas sebelum menyimpan provider; keduanya membuktikan key, Base URL, dan id model sekaligus, yang persis tidak akan dicek form untuk Anda. Saat AI step flow gagal setelah setup, baca error step-nya. Kegagalan autentikasi berarti field key atau nama header salah (atau prefix Bearer hilang di endpoint yang mensyaratkannya). Error model-not-found adalah id terdaftar yang tidak cocok dengan katalog. Error koneksi biasanya berarti Base URL kehilangan /v1-nya. Jika step tidak bisa menemukan model untuk dipilih, provider tersimpan tapi daftar model kosong untuk tipe model itu. Setelah flow berjalan, konsol APIsRouter menunjukkan model per request, hitungan token, dan pengeluaran. Otomasi terjadwal melipatgandakan diam-diam, dan tampilan penggunaan per-key adalah cara admin platform melihat flow mana yang layak atas token-nya sebelum invoice yang melakukannya.

Pertanyaan umum