Berikan flow Activepieces penyedia AI serasi OpenAI.

Updated 2026-07-29

Activepieces menyediakan jenis penyedia OpenAI Compatible dalam persediaan AI admin: Base URL, API Key Header, dan senarai model yang anda tentukan sendiri. Arahkan Base URL ke https://api.apisrouter.com/v1, daftarkan id model anda, dan setiap langkah AI dalam setiap flow berjalan melalui gateway pada satu kunci.

Jawapan pantas: satu entri penyedia dalam persediaan AI admin.

Dalam konsol admin Activepieces, buka halaman persediaan AI dan tambah penyedia jenis OpenAI Compatible. Borang itu mengambil Display Name, API Key, Base URL, API Key Header, header lalai pilihan, dan senarai model di mana setiap entri mempunyai Model ID, Model Name, dan Model Type. Nilai untuk APIsRouter: Base URL ialah https://api.apisrouter.com/v1 (bentuk yang sama digunakan codebase untuk penyedia serasi terbina dalamnya sendiri), API Key Header ialah Authorization, dan medan kunci mengambil kunci gateway anda. Satu perincian pelaksanaan berbaloi diketahui: Activepieces menghantar kunci dalam header itu tepat seperti yang anda taip, tanpa awalan Bearer ditambah secara automatik, jadi masukkan sebagai "Bearer sk-..." untuk bentuk kanonik; APIsRouter turut menerima kunci kosong dalam header Authorization, jadi kedua-dua ejaan berfungsi di sini. Kemudian tambah setiap model yang anda mahu flow lihat, dengan Model ID sepadan tepat 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 penyedia custom.

Activepieces (lebih kurang 23K bintang di GitHub) ialah platform automasi tanpa kod sumber terbuka terkemuka: flow dibina daripada trigger dan pieces, dalam bentuk Zapier tetapi boleh dihos sendiri, dengan rangka kerja piece berlesen MIT dan katalog komuniti yang besar. Keupayaan AI-nya (langkah penjanaan teks, agent, pieces utiliti AI) menyelesaikan model mereka melalui penyedia AI yang dikonfigurasikan platform, itulah sebab entri penyedia menjadi keputusan penghalaan untuk setiap flow serentak. Di sebalik tabir, penyedia OpenAI Compatible membina klien standard terhadap Base URL anda dan melampirkan kunci anda di bawah nama header yang anda pilih, ditambah header metadata per-larian yang mengenal pasti projek dan flow. Model ID yang anda daftarkan diteruskan sebagai rentetan model pada permintaan chat-completions. Tiada auto-discovery model untuk jenis penyedia ini: flow boleh memilih tepat model yang anda tambah ke senarai, yang mengekalkan pemilih disengajakan dan bukan dibanjiri. Konfigurasi penyedia adalah peringkat platform. Seorang admin mentakrifkannya sekali, dan setiap projek dan flow pada instans itu memilih daripada model yang didaftarkan. Pemusatan itu ialah kemenangan governan: satu tempat untuk memutuskan model mana yang wujud, satu kunci untuk mengukur semua langkah AI, dan metadata per-flow dalam setiap permintaan menjadikan penggunaan boleh dikaitkan apabila anda membaca log.

Persediaan penuh dan amaran masa simpan.

Borang itu menyimpan tanpa mengesahkan sambungan; pelaksanaan penyedia secara eksplisit melangkau semakan sambungan untuk jenis OpenAI Compatible. Itu mudah (tiada menguji endpoint anda pada masa simpan) tetapi bermaksud Base URL yang salah atau kunci yang cacat gagal kemudian, pada larian flow pertama yang menyentuh langkah AI. Sahkan endpoint secara manual sekali sebelum menyambungkannya ke flow produksi, dan anggap larian pertama sebagai sebahagian daripada persediaan. Model Type penting untuk pieces mana yang boleh guna entri itu: langkah teks mahukan model TEXT. Daftarkan id tepat seperti dieja katalog; Model Name ialah label paparan dan boleh menjadi apa sahaja yang boleh dibaca. Jika anda mahu model asas yang sama pada dua tahap harga-prestasi untuk pasukan berbeza, daftarkan sekali setiap Model ID; nama paparan mengekalkan mereka boleh dibezakan dalam pemilih.

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 langkah automasi.

Kerana penyedia itu merentasi platform, governan model ialah satu skrin: tambah id yang anda restui, perhatikan seminggu penggunaan per kunci, dan buang apa yang tiada siapa patut guna. Pembina flow mengekalkan kebebasan mereka dalam senarai yang anda kurasikan.

  • AI automasi ialah kerja volum tinggi, prompt pendek: klasifikasikan tiket, ekstrak medan, rangka mesej, ringkaskan payload webhook. claude-haiku-4-5-20251001, gpt-5.4-mini, dan deepseek-v4-flash merangkumi kebanyakan langkah pada harga volum.
  • Simpan id yang lebih kuat untuk langkah pertimbangan. Flow yang merangka balasan menghadap pelanggan atau membuat keputusan penghalaan layak mendapat claude-sonnet-4-6, dipilih setiap langkah dalam flow builder.
  • MiniMax-M2.7 dan keluarga DeepSeek berharga sangat baik untuk flow transformasi pukal (feed, pembersihan scraping, pengayaan) di mana ribuan larian sehari adalah biasa.
  • Flow berjalan tanpa pengawasan, jadi kos ialah jadual didarab dengan kiraan token per larian. Log penggunaan memberi anda nombor per larian; jadual itu milik anda.
  • Daftarkan sedikit model secara sengaja. Pemilih menunjukkan tepat apa yang anda tambah, dan senarai terpilih mengelakkan seratus pembina flow masing-masing memilih secara berbeza.

Bayar mengikut penggunaan · bawah harga rasmi

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

ModelHarga RasmiHarga Kami
Claude Haiku 4.5 20251001$1.00 / $5.00 per M$0.80 / $4.00 per M
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M
GPT-5.4 mini$0.75 / $4.50 per M$0.60 / $3.60 per M
DeepSeek V4 Flash$0.14 / $0.28 per M$0.10 / $0.30 per M
MiniMax M2.7$0.30 / $1.20 per M$0.30 / $1.20 per M

Mod kegagalan khusus Activepieces.

Simpan senyap, larian pertama bising. Kerana penyedia OpenAI Compatible melangkau pengesahan sambungan, setiap kesilapan sambungan (Base URL salah, /v1 hilang, kunci rosak, nama header salah) muncul sebagai langkah AI yang gagal dalam larian flow dan bukan ralat borang. Apabila langkah AI gagal sejurus selepas perubahan penyedia, syak entri penyedia sebelum flow itu. Soalan awalan Bearer. Kunci dihantar verbatim di bawah header pilihan anda. Endpoint yang memerlukan awalan Bearer literal perlukannya ditaip ke dalam medan kunci; APIsRouter menerima kedua-dua bentuk, tetapi jika anda pernah mengarahkan semula penyedia ini ke tempat lain, ingat platform tidak akan menambah awalan itu untuk anda. Model IDs adalah tepat. Id berdaftar dengan kesilapan taip melepasi borang (label adalah teks bebas) dan gagal pada masa larian dengan model-not-found; output /v1/models gateway adalah ejaan berwibawa. Tiada auto-discovery adalah ciri, bukan pepijat. Jika model hilang daripada pemilih flow, ia tidak didaftarkan pada penyedia; tambah dalam konsol admin dan bukan memburu dalam flow builder. Dan kekalkan sambungan peringkat piece berasingan dalam fikiran anda: pieces individu seperti piece OpenAI boleh menyimpan kelayakan sendiri per sambungan, manakala entri penyedia yang diterangkan di sini menggerakkan keupayaan AI sejagat platform. Jika flow menggunakan piece khusus vendor dengan sambungan sendiri, trafik itu tidak menghalakan melalui entri gateway anda.

Siapa yang menghalakan Activepieces melalui gateway.

  • Pasukan self-hosting yang menyeragamkan AI merentasi berpuluh flow, di mana satu entri penyedia dan satu kunci menggantikan kelayakan per-piece yang berselerak.
  • Admin platform yang mahukan governan model: senarai model terkurasi, penggunaan per kunci, dan keupayaan menukar endpoint sokongan tanpa menyentuh flow.
  • Agensi yang menjalankan automasi klien pada satu instans, mengukur penggunaan AI per klien dengan kunci berasingan pada katalog yang sama.
  • Pembina yang flow mereka mencampur langkah volum dan langkah pertimbangan, menggandingkan id pantas dengan id frontier setiap langkah melalui satu endpoint.
  • Pembangun tanpa akses kepada pengebilan vendor tertentu. Akses berasaskan top-up tanpa keperluan kad menghapuskan kebergantungan pendaftaran setiap penyedia.

Sahkan endpoint dan nyahpepijat langkah AI pertama.

Jalankan dua curl di atas sebelum menyimpan penyedia; ia membuktikan kunci, Base URL, dan id model bersama, tepat apa yang tidak akan disemak borang untuk anda. Apabila langkah AI flow gagal selepas persediaan, baca ralat langkah itu. Kegagalan pengesahan bermaksud medan kunci atau nama header salah (atau awalan Bearer hilang pada endpoint yang memerlukannya). Ralat model-not-found ialah id berdaftar yang tidak sepadan dengan katalog. Ralat sambungan biasanya bermaksud Base URL kehilangan /v1-nya. Jika langkah itu tidak dapat mencari mana-mana model untuk dipilih, penyedia telah disimpan tetapi senarai model kosong untuk jenis model itu. Sebaik sahaja flow berjalan, konsol APIsRouter menunjukkan model per permintaan, kiraan token, dan perbelanjaan. Automasi berjadual mengumpul secara senyap, dan pandangan penggunaan per kunci adalah cara admin platform melihat flow mana yang berbaloi token mereka sebelum invois melakukannya.

Soalan lazim

Adakah Activepieces menyokong penyedia AI serasi OpenAI custom?

Ya, sebagai jenis penyedia terbina dalam. Persediaan AI admin merangkumi pilihan OpenAI Compatible dengan Base URL, API Key, API Key Header, header lalai pilihan, dan senarai model yang anda tentukan setiap Model ID dan jenis.

Apa yang dimasukkan dalam medan API Key Header untuk APIsRouter?

Authorization. Activepieces menghantar kunci anda di bawah header itu tepat seperti ditaip, tanpa menambah awalan Bearer, jadi masukkan kunci sebagai "Bearer sk-..." untuk bentuk kanonik; APIsRouter turut menerima kunci kosong.

Bolehkah flow menggunakan model Claude, DeepSeek, atau MiniMax melalui penyedia ini?

Ya. Model IDs berdaftar diteruskan sebagai rentetan biasa melalui chat completions ke Base URL, jadi mana-mana id yang dilayani gateway berfungsi: claude-haiku-4-5-20251001, deepseek-v4-flash, MiniMax-M2.7, dan selebihnya katalog.

Mengapa penyedia berjaya disimpan tetapi langkah AI flow saya gagal?

Penyedia OpenAI Compatible dengan sengaja melangkau pengesahan sambungan pada masa simpan. Kesilapan sambungan muncul pada larian flow pertama sebaliknya; sahkan Base URL, kunci, dan id model dengan permintaan manual dan semak semula entri itu.

Mengapa model baharu tidak muncul dalam pemilih model flow saya?

Jenis penyedia ini tiada auto-discovery; flow melihat tepat model yang didaftarkan pada entri penyedia. Tambah Model ID dalam konsol admin dan ia muncul dalam pemilih serta-merta.

Adakah penyedia itu per projek atau merentasi platform?

Merentasi platform. Seorang admin mengkonfigurasinya sekali dan flow setiap projek memilih daripada model yang didaftarkan. Permintaan membawa header metadata projek dan flow, yang membantu mengaitkan penggunaan apabila anda membaca log.