Activepieces flows کو ایک OpenAI-compatible AI provider دیں۔

فوری جواب: admin AI setup میں ایک provider entry۔

Activepieces admin console میں، AI setup page کھولیں اور OpenAI Compatible type کا ایک provider شامل کریں۔ form Display Name، API Key، Base URL، API Key Header، optional default headers، اور ایک model list لیتا ہے جہاں ہر entry کی ایک Model ID، Model Name، اور Model Type ہوتی ہے۔ APIsRouter کے لیے values: Base URL ہے https://api.apisrouter.com/v1 (وہی shape جو codebase اپنے built-in compatible providers کے لیے استعمال کرتا ہے)، API Key Header ہے Authorization، اور key field آپ کی gateway key لیتی ہے۔ ایک implementation detail جاننے کے قابل ہے: Activepieces وہ key اس header میں بالکل ویسے ہی بھیجتا ہے جیسے آپ نے ٹائپ کی، بغیر خودکار Bearer prefix کے، تو canonical form کے لیے اسے "Bearer sk-..." کے طور پر داخل کریں؛ APIsRouter بھی Authorization header میں بغیر prefix والی key قبول کرتا ہے، تو یہاں دونوں spelling چلتی ہیں۔ پھر ہر وہ model شامل کریں جسے flows دیکھیں، Model ID کیٹلاگ سے بالکل میچ ہونی چاہیے۔

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 custom provider کیسے استعمال کرتا ہے۔

Activepieces (GitHub پر تقریباً 23K stars) leading open-source no-code automation platform ہے: triggers اور pieces سے بنے flows، Zapier والی shape میں مگر self-hostable، ایک MIT-licensed piece framework اور ایک بڑے community catalog کے ساتھ۔ اس کی AI capabilities (text generation steps، agents، AI utility pieces) اپنا model platform کی configured AI providers سے resolve کرتی ہیں، یہی وجہ ہے کہ provider entry ایک ساتھ ہر flow کے لیے routing decision بن جاتی ہے۔ اندر سے، OpenAI Compatible provider آپ کے Base URL کے خلاف ایک standard client بناتا ہے اور آپ کی key کو منتخب کردہ header کے نام کے ساتھ attach کرتا ہے، ساتھ ہی per-run metadata headers جو project اور flow کی شناخت کرتے ہیں۔ آپ نے جو Model ID register کی وہ chat-completions requests پر model string کے طور پر pass ہوتی ہے۔ اس provider type کے لیے کوئی model auto-discovery نہیں: flows بالکل وہی models select کر سکتے ہیں جو آپ نے list میں شامل کی ہیں، جو picker کو intentional رکھتا ہے نہ کہ بھرا ہوا۔ Provider configuration platform-level ہے۔ ایک admin اسے ایک بار define کرتا ہے، اور instance کا ہر project اور flow registered models میں سے select کرتا ہے۔ یہی centralization governance کی جیت ہے: کون سے models موجود ہیں یہ فیصلہ کرنے کی ایک جگہ، تمام AI steps meter کرنے کی ایک key، اور ہر request میں per-flow metadata جو logs پڑھتے وقت usage کو attributable بناتا ہے۔

مکمل سیٹ اپ اور save-time کی احتیاط۔

form connection کو validate کیے بغیر save ہو جاتا ہے؛ provider implementation OpenAI Compatible type کے لیے connection checks کو صراحتاً skip کرتی ہے۔ یہ آسان تو ہے (save کے وقت آپ کے endpoint کی probing نہیں) مگر اس کا مطلب ہے کہ غلط Base URL یا malformed key بعد میں فیل ہوتی ہے، پہلے flow run پر جو AI step کو چھوئے۔ production flows میں wire کرنے سے پہلے ایک بار endpoint کو ہاتھ سے verify کریں، اور پہلے run کو setup کا حصہ سمجھیں۔ Model Type اس بات کے لیے اہم ہے کہ pieces entry کو استعمال کر سکیں یا نہیں: text steps کو TEXT models چاہئیں۔ id کو بالکل ویسے register کریں جیسے کیٹلاگ اسے لکھتا ہے؛ Model Name صرف ایک display label ہے اور کچھ بھی readable ہو سکتی ہے۔ اگر آپ مختلف teams کے لیے ایک ہی underlying model کو دو price-performance tiers پر چاہتے ہیں، تو اسے ہر Model ID کے لیے ایک بار register کریں؛ display names انہیں 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"}]}'

Automation steps کے لیے models چننا۔

چونکہ provider platform-wide ہے، model governance ایک ہی screen ہے: جن ids کو آپ منظور کرتے ہیں انہیں شامل کریں، ہر key پر ایک ہفتے کا usage دیکھیں، اور جو کسی کو استعمال نہیں کرنا چاہیے اسے کاٹ دیں۔ Flow builders آپ کے curated کردہ list کے اندر اپنی آزادی برقرار رکھتے ہیں۔

• Automation AI زیادہ volume، مختصر-prompt والا کام ہے: ٹکٹ classify کرنا، fields extract کرنا، message draft کرنا، webhook payload summarize کرنا۔ claude-haiku-4-5-20251001، gpt-5.4-mini، اور deepseek-v4-flash volume قیمت پر زیادہ تر steps cover کرتے ہیں۔
• judgment steps کے لیے ایک stronger id محفوظ رکھیں۔ کوئی flow جو customer-facing replies drafts کرے یا routing decisions لے وہ claude-sonnet-4-6 کا حق دار ہے، flow builder میں per step select کیا گیا۔
• MiniMax-M2.7 اور DeepSeek family bulk transformation flows (feeds، scraping cleanups، enrichment) کے لیے انتہائی اچھی قیمت رکھتے ہیں جہاں روزانہ ہزاروں runs عام بات ہے۔
• Flows بغیر نگرانی کے چلتے ہیں، تو cost ایک schedule ہے جو per-run token count سے ضرب کھاتا ہے۔ usage log آپ کو per-run number دیتا ہے؛ schedule آپ کا اپنا ہے۔
• جان بوجھ کر کم models register کریں۔ picker بالکل وہی دکھاتا ہے جو آپ نے شامل کیا، اور ایک curated list سو flow builders کو الگ الگ چننے سے روکتی ہے۔

استعمال کے مطابق ادائیگی · سرکاری قیمت سے کم

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

Activepieces سے مخصوص failure modes۔

خاموش save، شور مچاتا پہلا run۔ چونکہ OpenAI Compatible provider connection validation کو skip کرتا ہے، ہر wiring غلطی (غلط Base URL، missing /v1، خراب key، غلط header name) flow run میں ایک failed AI step کے طور پر سامنے آتی ہے نہ کہ form error کے طور پر۔ جب provider changes کے فوراً بعد کوئی AI step فیل ہو، تو flow سے پہلے provider entry پر شک کریں۔ Bearer prefix کا سوال۔ key آپ کے منتخب کردہ header کے تحت جوں کی توں بھیجی جاتی ہے۔ جن endpoints کو literal Bearer prefix چاہیے انہیں key field میں ٹائپ کرنا ہو گا؛ APIsRouter دونوں forms قبول کرتا ہے، مگر اگر آپ کبھی اس provider کو کہیں اور point کریں، یاد رکھیں platform آپ کے لیے prefix نہیں لگائے گا۔ Model IDs exact ہوتے ہیں۔ typo والی registered id form سے گزر جاتی ہے (labels free text ہیں) اور run time پر model-not-found سے فیل ہوتی ہے؛ gateway کا /v1/models output ہی authoritative spelling ہے۔ No auto-discovery ایک feature ہے، bug نہیں۔ اگر کوئی model flow کے picker سے missing ہے، تو وہ provider پر register نہیں ہوئی؛ flow builder میں ڈھونڈنے کی بجائے admin console میں شامل کریں۔ اور piece-level connections کو ذہن میں الگ رکھیں: OpenAI piece جیسے individual pieces اپنے connection کے مطابق اپنی credentials رکھ سکتے ہیں، جبکہ یہاں بیان کردہ provider entry platform کی universal AI capabilities چلاتی ہے۔ اگر کوئی flow اپنے connection والا vendor-specific piece استعمال کرے، تو وہ traffic آپ کی gateway entry سے route نہیں ہوتی۔

Activepieces کو gateway کے ذریعے کون route کرتا ہے۔

• وہ self-hosting teams جو درجنوں flows میں AI کو standardize کرتی ہیں، جہاں ایک provider entry اور ایک key بکھری ہوئی per-piece credentials کی جگہ لیتی ہیں۔
• وہ platform admins جو model governance چاہتے ہیں: ایک curated model list، per-key usage، اور flows کو چھوئے بغیر backing endpoint بدلنے کی صلاحیت۔
• وہ agencies جو ایک instance پر client automations چلاتی ہیں، ایک ہی catalog پر الگ keys کے ساتھ ہر client کی AI usage meter کرتی ہیں۔
• وہ builders جن کے flows volume steps اور judgment steps مکس کرتے ہیں، ہر step پر تیز ids کو frontier ids کے ساتھ ایک endpoint کے ذریعے pair کرتے ہوئے۔
• وہ developers جن کے پاس کسی مخصوص vendor کی billing تک رسائی نہیں۔ Top-up پر مبنی رسائی بغیر کارڈ کی شرط کے فی-provider sign-up کا انحصار ختم کر دیتی ہے۔

Endpoint verify کریں اور پہلا AI step debug کریں۔

provider save کرنے سے پہلے اوپر دونوں curls چلائیں؛ وہ key، Base URL، اور model id تینوں کو ایک ساتھ ثابت کرتے ہیں، جو بالکل وہی چیز ہے جو form آپ کے لیے چیک نہیں کرے گا۔ جب setup کے بعد کسی flow کا AI step فیل ہو، تو step error پڑھیں۔ Authentication failures کا مطلب ہے key field یا header name غلط ہے (یا جس endpoint کو Bearer prefix چاہیے وہاں یہ missing ہے)۔ Model-not-found error کا مطلب ایک registered id ہے جو کیٹلاگ سے میچ نہیں کرتی۔ Connection error عموماً اس بات کا مطلب ہے کہ Base URL نے اپنا /v1 کھو دیا۔ اگر step کسی model کو select کرنے کے لیے نہیں پا رہا، تو provider save ہو گیا مگر اس model type کے لیے model list خالی ہے۔ جب flows چلنے لگیں، تو APIsRouter console per-request model، token counts، اور spend دکھاتا ہے۔ Scheduled automations خاموشی سے compound ہوتی ہیں، اور per-key usage view یہی ہے کہ platform admin کیسے دیکھتا ہے کہ کون سے flows invoice سے پہلے اپنے tokens کما رہے ہیں۔

عمومی سوالات