# Felo API সেটআপ

প্ল্যাটফর্ম ব্যালেন্স ব্যবহার করে অনুসন্ধান, ওয়েব কনটেন্ট, X ডেটা এবং প্রেজেন্টেশনের জন্য Data API-তে Felo এন্ডপয়েন্ট সেট আপ করুন।

Felo হলো [Data API](https://openapi.felo.ai/bn/docs/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](https://openapi.felo.ai/bn/docs/api-reference/felo-apis.md) দেখুন। Platform balance এবং Pro credits আলাদা।

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

1. [Console → API Keys](https://openapi.felo.ai/console/api-keys)-এ একটি key তৈরি করুন।
2. [Console → Billing](https://openapi.felo.ai/console/billing)-এ আপনার **platform balance** পরীক্ষা করুন বা top up করুন।
3. আপনার server-এ বা local shell-এ key সেট করুন:

```bash
export FELO_API_KEY="YOUR_API_KEY"
```

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

```bash
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](https://openapi.felo.ai/bn/docs/data-api/guides/felo-chat.md) ব্যবহার করুন।

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

| নির্দেশিকা | কার্যক্রম | আপনি যা পাবেন | বিলিং একক |
| --- | --- | --- | --- |
| [ওয়েব অনুসন্ধান](https://openapi.felo.ai/bn/docs/data-api/guides/felo-web-search.md) | ওয়েবে অনুসন্ধান করুন | পৃষ্ঠা শিরোনাম, লিংক এবং স্নিপেট | অনুরোধ |
| [ওয়েব পড়া](https://openapi.felo.ai/bn/docs/data-api/guides/felo-web-read.md) | একটি URL পড়ুন | Markdown, পাঠ্য, HTML অথবা স্ক্রিনশট | অনুরোধ |
| [X ডেটা](https://openapi.felo.ai/bn/docs/data-api/guides/felo-x-data.md) | প্রোফাইল, ব্যবহারকারী অনুসন্ধান, ব্যবহারকারী পোস্ট, পোস্ট অনুসন্ধান, উত্তরসমূহ | কাঠামোবদ্ধ ব্যবহারকারী এবং পোস্ট, যেখানে সমর্থিত সেখানে পেজিনেশনসহ | ফেরত পাওয়া ফলাফল |
| [অনুসন্ধান-ভিত্তিক চ্যাট](https://openapi.felo.ai/bn/docs/data-api/guides/felo-chat.md) | একটি প্রশ্নের উত্তর দিন | উত্তর এবং ওয়েব উৎসসমূহ | অনুরোধ |
| [পিপিটি](https://openapi.felo.ai/bn/docs/data-api/guides/felo-ppt.md) | তৈরি, অবস্থা, ফলাফল, রপ্তানি, রপ্তানি অবস্থা, মুছুন | তৈরির কার্য এবং ডাউনলোডযোগ্য PPTX | তৈরি হওয়া পৃষ্ঠা; রপ্তানি আলাদাভাবে বিল করা হয় |
| [বিলিং এবং ত্রুটি](https://openapi.felo.ai/bn/docs/data-api/guides/felo-billing.md) | যৌথ সমন্বয় নির্দেশনা | মূল্য, ব্যালেন্স ব্যবস্থাপনা এবং পুনরায় চেষ্টা করার নিয়ম | — |

এই গাইডগুলোর মধ্যে **14টি core operation** আছে। যদি PPT creation একটি `stream_key` ফেরত দেয়, তবে [PPT guide](https://openapi.felo.ai/bn/docs/data-api/guides/felo-ppt.md#sse)-এ 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](https://openapi.felo.ai/bn/docs/api-reference/felo-apis.md) এবং Pro-credit billing ব্যবহার চালিয়ে যান।

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

- [Published OpenAPI schema](https://openapi.felo.ai/api/v1/data/openapi.json) — field definition এবং response schema।
- [OpenAPI YAML schema](https://openapi.felo.ai/api/v1/data/openapi.yaml) — YAML গ্রহণ করে এমন tool-এর জন্য।
- [Current prices](https://openapi.felo.ai/api/v1/data/prices) — operation ID, billing unit এবং বর্তমান rate।

এই resource-গুলো public এবং key ছাড়াই পড়া যায়। Automatic retry যোগ করার আগে [Billing and Errors](https://openapi.felo.ai/bn/docs/data-api/guides/felo-billing.md) দেখুন。