Felo API সেটআপ

Felo হলো Data API-এর একটি provider, যা ওয়েব অনুসন্ধান, ওয়েব রিডিং, X data, অনুসন্ধান-ভিত্তিক উত্তর এবং প্রেজেন্টেশন সরবরাহ করে। প্রাসঙ্গিক Data API category-তে অন্যান্য provider-এর পাশাপাশি প্রতিটি Felo endpoint খুঁজে পাবেন।

এই endpoint-গুলো platform balance এবং /api/v1/data prefix ব্যবহার করে। এই গাইডে authentication, আপনার প্রথম request এবং billing rules কোথায় পাওয়া যাবে তা ব্যাখ্যা করা হয়েছে।

Felo Pro credits ব্যবহার করতে চাইলে, existing Felo APIs দেখুন। Platform balance এবং Pro credits আলাদা।

আপনার প্রথম অনুরোধ করুন

1. Console → API Keys-এ একটি key তৈরি করুন।
2. Console → Billing-এ আপনার platform balance পরীক্ষা করুন বা top up করুন।
3. আপনার server-এ বা local shell-এ key সেট করুন:

export FELO_API_KEY="YOUR_API_KEY"

Authorization: Bearer $FELO_API_KEY পাঠান। X-API-Key-ও গ্রহণযোগ্য; একটি authentication method বেছে নিন। JSON request-এর জন্য Content-Type: application/json প্রয়োজন।

curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"What is retrieval augmented generation?","count":3}'

HTTP 200 page title, link এবং snippet-সহ একটি resources array ফেরত দেয়, সাথে total। এটি conversational answer তৈরি করে না; তার জন্য Chat ব্যবহার করুন।

API সমূহ অন্বেষণ করুন

এই গাইডগুলোর মধ্যে 14টি core operation আছে। যদি PPT creation একটি stream_key ফেরত দেয়, তবে PPT guide-এ SSE দিয়ে generation event কীভাবে পড়তে হয় তাও ব্যাখ্যা করা হয়েছে। Status এবং result query, export-status query এবং deletion নতুন চার্জ তৈরি করে না।

বিদ্যমান সমন্বয় স্থানান্তরের আগে

আপনি যে নির্দিষ্ট endpoint কল করেন, তার গাইড ব্যবহার করুন। /v2-কে /api/v1/data দিয়ে প্রতিস্থাপন করা সম্পূর্ণ migration নয়:

• Web Read /web/read ব্যবহার করে, এবং প্রতি request-এ একটি output format ব্যবহার হয়।
• Chat status: "ok" ফেরত দেয়; এটি শুধু non-streaming JSON সমর্থন করে।
• PPT results POST /tasks/{task_id}/historical ব্যবহার করে।
• PPT creation JSON root-এ identifier ফেরত দেয়। task_id এবং ppt_business_id—দুটিই সংরক্ষণ করুন।
• জেনারেট হওয়া PPT সাত দিনের পর মেয়াদোত্তীর্ণ হয়। মেয়াদ শেষ হওয়ার আগে আপনার file export ও save করুন।

এখানে প্রতিটি /v2 workflow-এর জন্য native OpenAPI equivalent নথিভুক্ত নেই, যেমন LiveDoc CRUD, Mindmap বা SuperAgent। তাদের Felo APIs guides এবং Pro-credit billing ব্যবহার চালিয়ে যান।

চুক্তি এবং বর্তমান মূল্য

• Published OpenAPI schema — field definition এবং response schema।
• OpenAPI YAML schema — YAML গ্রহণ করে এমন tool-এর জন্য।
• Current prices — operation ID, billing unit এবং বর্তমান rate।

এই resource-গুলো public এবং key ছাড়াই পড়া যায়। Automatic retry যোগ করার আগে Billing and Errors দেখুন。