Trang bị cho flow Activepieces một AI provider tương thích OpenAI.

Câu trả lời nhanh: một mục provider trong phần thiết lập AI của admin.

Trong admin console của Activepieces, mở trang thiết lập AI và thêm một provider kiểu OpenAI Compatible. Form này nhận Display Name, API Key, Base URL, API Key Header, header mặc định tùy chọn, và một danh sách model mà mỗi entry có Model ID, Model Name, và Model Type. Giá trị cho APIsRouter: Base URL là https://api.apisrouter.com/v1 (đúng hình dạng mà codebase dùng cho các compatible provider có sẵn của chính nó), API Key Header là Authorization, và field key nhận key gateway của bạn. Một chi tiết triển khai đáng biết: Activepieces gửi key trong header đó đúng như bạn gõ, không tự động thêm tiền tố Bearer, nên hãy nhập nó dạng "Bearer sk-..." cho hình thức chuẩn; APIsRouter cũng chấp nhận key trần trong header Authorization, nên cả hai cách viết đều dùng được ở đây. Sau đó thêm từng model bạn muốn flow nhìn thấy, với Model ID khớp chính xác với catalog.

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

Cách Activepieces dùng một custom provider.

Activepieces (khoảng 23K star trên GitHub) là nền tảng automation no-code mã nguồn mở hàng đầu: flow được xây từ trigger và piece, cùng hình dạng với Zapier nhưng tự host được, với framework piece cấp phép MIT và một catalog cộng đồng lớn. Các năng lực AI của nó (bước tạo văn bản, agent, piece tiện ích AI) phân giải model của chúng qua các AI provider đã cấu hình của nền tảng, đây là lý do mục provider trở thành một quyết định định tuyến cho mọi flow cùng lúc. Bên dưới, provider OpenAI Compatible xây một client chuẩn nhắm vào Base URL của bạn và gắn key của bạn dưới tên header bạn chọn, cộng thêm các header metadata theo từng lần chạy nhận diện project và flow. Model ID bạn đăng ký được chuyển thẳng làm chuỗi model trên các request chat-completions. Kiểu provider này không có auto-discovery model: flow chỉ có thể chọn đúng các model bạn đã thêm vào danh sách, giữ cho bộ chọn có chủ đích thay vì tràn ngập. Cấu hình provider ở cấp nền tảng. Một admin định nghĩa nó một lần, và mọi project cùng flow trên instance chọn từ các model đã đăng ký. Sự tập trung đó chính là lợi ích quản trị: một nơi để quyết định model nào tồn tại, một key để đo lường mọi bước AI, và metadata theo từng flow trong mỗi request giúp quy trách nhiệm sử dụng khi bạn đọc log.

Cài đặt đầy đủ và lưu ý về thời điểm lưu.

Form lưu mà không xác thực kết nối; phần triển khai provider chủ động bỏ qua kiểm tra kết nối cho kiểu OpenAI Compatible. Điều đó tiện lợi (không dò endpoint của bạn lúc lưu) nhưng nghĩa là một Base URL sai hoặc key sai định dạng sẽ thất bại về sau, ở lần chạy flow đầu tiên chạm tới một bước AI. Hãy tự tay xác minh endpoint một lần trước khi nối nó vào flow production, và coi lần chạy đầu là một phần của cài đặt. Model Type quan trọng với việc piece nào có thể dùng entry: bước văn bản cần model TEXT. Đăng ký id chính xác như catalog viết; Model Name là nhãn hiển thị và có thể là bất cứ gì dễ đọc. Nếu bạn muốn cùng một model nền ở hai mức giá/hiệu năng cho các đội khác nhau, đăng ký nó một lần cho mỗi Model ID; tên hiển thị giữ chúng phân biệt được trong bộ chọn.

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

Chọn model cho các bước automation.

Vì provider mang tính toàn nền tảng, quản trị model chỉ là một màn hình: thêm các id bạn chuẩn thuận, theo dõi một tuần sử dụng theo từng key, và cắt bỏ những gì không ai nên dùng. Người xây flow giữ được sự tự do trong danh sách bạn đã chọn lọc.

• AI automation là công việc khối lượng lớn, prompt ngắn: phân loại một ticket, trích xuất trường dữ liệu, soạn một tin nhắn, tóm tắt một payload webhook. claude-haiku-4-5-20251001, gpt-5.4-mini, và deepseek-v4-flash bao phủ hầu hết các bước với giá theo khối lượng.
• Dành một id mạnh hơn cho các bước cần phán đoán. Một flow soạn trả lời hướng tới khách hàng hoặc ra quyết định định tuyến xứng đáng với claude-sonnet-4-6, chọn riêng theo từng bước trong flow builder.
• MiniMax-M2.7 và họ DeepSeek định giá cực tốt cho các flow biến đổi hàng loạt (feed, dọn dẹp scraping, làm giàu dữ liệu) nơi hàng nghìn lần chạy mỗi ngày là chuyện bình thường.
• Flow chạy không người giám sát, nên chi phí là lịch chạy nhân với số token mỗi lần chạy. Log sử dụng cho bạn con số mỗi lần chạy; lịch chạy là của bạn.
• Đăng ký ít model một cách có chủ đích. Bộ chọn hiển thị đúng những gì bạn đã thêm, và một danh sách được chọn lọc giúp hàng trăm người xây flow không mỗi người chọn một kiểu.

Trả theo mức sử dụng · thấp hơn giá chính thức

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

Các kiểu lỗi đặc thù của Activepieces.

Lưu im lặng, lần chạy đầu ồn ào. Vì provider OpenAI Compatible bỏ qua xác thực kết nối, mọi lỗi nối dây (Base URL sai, thiếu /v1, key sai, tên header sai) hiện ra như một bước AI thất bại trong một lần chạy flow thay vì lỗi trên form. Khi một bước AI thất bại ngay sau khi đổi provider, hãy nghi ngờ mục provider trước khi nghi ngờ flow. Câu hỏi về tiền tố Bearer. Key được gửi nguyên văn dưới header bạn chọn. Các endpoint yêu cầu tiền tố Bearer theo nghĩa đen cần nó được gõ vào field key; APIsRouter chấp nhận cả hai dạng, nhưng nếu sau này bạn trỏ provider này sang nơi khác, hãy nhớ nền tảng sẽ không tự thêm tiền tố cho bạn. Model ID phải chính xác. Một id đăng ký sai chính tả vẫn qua được form (nhãn là văn bản tự do) và thất bại lúc chạy với lỗi model-not-found; output /v1/models của gateway là cách viết chuẩn. Không có auto-discovery là một tính năng, không phải lỗi. Nếu một model thiếu trong bộ chọn của flow, nó chưa được đăng ký trên provider; hãy thêm nó trong admin console thay vì tìm kiếm trong flow builder. Và giữ trong đầu rằng các kết nối cấp piece là riêng biệt: các piece riêng lẻ như piece OpenAI có thể giữ credential riêng theo từng kết nối, trong khi mục provider mô tả ở đây cấp năng lượng cho các năng lực AI phổ quát của nền tảng. Nếu một flow dùng một piece đặc thù của vendor với kết nối riêng của nó, lưu lượng đó không định tuyến qua mục gateway của bạn.

Ai định tuyến Activepieces qua một gateway.

• Các đội tự host đang chuẩn hóa AI trên hàng chục flow, nơi một mục provider và một key thay thế các credential rải rác theo từng piece.
• Admin nền tảng muốn quản trị model: một danh sách model được chọn lọc, sử dụng theo từng key, và khả năng đổi endpoint nền mà không đụng vào flow.
• Agency chạy automation của khách hàng trên một instance, đo lường sử dụng AI theo từng khách hàng bằng các key riêng trên cùng catalog.
• Người xây dựng có flow trộn cả bước khối lượng lớn và bước cần phán đoán, ghép id nhanh với id đỉnh cao theo từng bước qua một endpoint.
• Lập trình viên không có quyền truy cập billing của một vendor cụ thể. Truy cập dựa trên nạp tiền không yêu cầu thẻ loại bỏ phụ thuộc đăng ký theo từng provider.

Xác minh endpoint và debug bước AI đầu tiên.

Chạy hai lệnh curl ở trên trước khi lưu provider; chúng chứng minh key, Base URL, và model id cùng lúc, đúng thứ mà form sẽ không kiểm tra giúp bạn. Khi bước AI của một flow thất bại sau khi thiết lập, hãy đọc lỗi của bước đó. Lỗi xác thực nghĩa là field key hoặc tên header sai (hoặc thiếu tiền tố Bearer trên một endpoint yêu cầu nó). Lỗi model-not-found là một id đã đăng ký không khớp catalog. Lỗi kết nối thường nghĩa là Base URL mất /v1. Nếu bước không tìm thấy model nào để chọn, provider đã lưu nhưng danh sách model rỗng cho kiểu model đó. Khi flow đã chạy, console APIsRouter hiển thị model theo từng request, số lượng token, và chi tiêu. Automation theo lịch tích lũy âm thầm, và góc nhìn sử dụng theo từng key là cách một admin nền tảng thấy flow nào xứng đáng với token của nó trước khi hóa đơn tới.

Câu hỏi thường gặp