# مرور APIهای Felo

Felo workflows under /v2, called with Felo Pro credits. Compare them with platform-balance APIs.

برای پرداخت جستجوی وب، خواندن وب، داده‌های X، Chat یا PPT با **موجودی پلتفرم**، از [Felo در Data API](https://openapi.felo.ai/fa/docs/api-reference/openapi/overview.md) استفاده کنید. این صفحه APIهای موجود `/v2` را مستند می‌کند که از **اعتبارات Felo Pro** استفاده می‌کنند.

APIهای Felo، APIهای بومیِ سطح گردش‌کار برای جستجو، اسناد، ارائه‌ها، استخراج وب، جستجوی اجتماعی و گردش‌کارهای عامل هستند. آن‌ها از همان کلید API Felo مانند بقیه پلتفرم استفاده می‌کنند، اما جدا از تماس‌های مدل صورتحساب می‌شوند.

::: tip Felo Pro subscription credits
**APIهای Felo در حال حاضر اعتبارات اشتراک Felo Pro را می‌پذیرند.** این مورد برای APIهای بومی `/v2` در این بخش اعمال می‌شود: Felo Search، PPT Task، Mindmap، LiveDoc، Web Fetch، X Search، YouTube Subtitling، Landing Page و SuperAgent.

این مورد برای تماس‌های Model API (`/api/v1`) اعمال نمی‌شود. تماس‌های مدل به اعتبارات خدمات از پیش‌پرداخت‌شده Felo API Platform نیاز دارند؛ اعتبارات اشتراک Felo Pro برای آن‌ها قابل استفاده نیست.
:::

واجد شرایط بودن می‌تواند تغییر کند. صفحه [Console Billing](https://openapi.felo.ai/console/billing) منبع نهاییِ موجودی و استفاده فعلی شماست.

## APIهای این بخش

| API | پایانه | برای چه استفاده می‌شود |
|---|---|---|
| [Felo Search API](https://openapi.felo.ai/fa/docs/api-reference/chat.md) | `POST /v2/chat` | جستجوی وب محاوره‌ای با تحلیل پرس‌وجو، منابع و استنادها |
| [PPT Task API](https://openapi.felo.ai/fa/docs/api-reference/ppt-tasks.md) | `POST /v2/ppts` | تولید بسته‌های اسلاید و بررسی وضعیت وظیفه |
| [Mindmap API](https://openapi.felo.ai/fa/docs/api-reference/mindmap.md) | `POST /v2/mindmap` | تبدیل یک prompt یا زمینه LiveDoc به mindmap |
| [LiveDoc API](https://openapi.felo.ai/fa/docs/api-reference/livedocs.md) | `POST /v2/livedocs` | ایجاد پایگاه‌های دانش، مدیریت منابع و بازیابی زمینه |
| [Web Fetch API](https://openapi.felo.ai/fa/docs/api-reference/web-fetch.md) | `POST /v2/web/extract` | استخراج یک صفحه وب به‌صورت HTML، متن یا Markdown |
| [X Search API](https://openapi.felo.ai/fa/docs/api-reference/x-search.md) | `POST /v2/x/tweet/search` | جستجوی کاربران X، توییت‌ها، تایم‌لاین‌ها و پاسخ‌ها |
| [YouTube Subtitling API](https://openapi.felo.ai/fa/docs/api-reference/youtube-subtitling.md) | `GET /v2/youtube/subtitling` | دریافت زیرنویس‌ها و زمان‌مهرهای YouTube |
| [Landing Page Task API](https://openapi.felo.ai/fa/docs/api-reference/landing-page.md) | `POST /v2/landing_page` | تولید یک صفحه فرود به‌صورت غیرهمزمان |
| [SuperAgent API](https://openapi.felo.ai/fa/docs/api-reference/superagent.md) | `POST /v2/conversations` | اجرای یک گفت‌وگوی عامل روی SSE |

## احراز هویت و اولین تماس

یک کلید API Felo در [Console → API Keys](https://openapi.felo.ai/console/api-keys) ایجاد کنید و آن را به‌صورت یک Bearer token ارسال کنید.

```bash
export FELO_API_KEY="YOUR_API_KEY"

curl -sS https://openapi.felo.ai/v2/chat \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"What are the latest AI agent trends?"}'
```

یک پاسخ موفق شامل یک پاسخ، تحلیل پرس‌وجو و منابع وب استنادشده است.

## مدل صورتحساب

| سطح | مسیر | هزینه تماس‌ها چگونه پرداخت می‌شود |
|---|---|---|
| APIهای Felo | `/v2/*` | اعتبارات Felo Pro |
| [Felo in Data API](https://openapi.felo.ai/fa/docs/api-reference/openapi/overview.md) | `/api/v1/data/*` | موجودی پلتفرم، نه اعتبارات Pro |
| Model API | `/api/v1/*` | فقط اعتبارات خدماتی Felo API Platform از پیش‌پرداخت‌شده؛ Felo Pro اعمال نمی‌شود |
| Data API | `/v1/beta/*` | از مبنای صورتحساب فهرست API که برای هر endpoint نشان داده شده استفاده می‌کند |

اعتبارات Felo Pro و اعتبارات خدمات API دو موجودی جداگانه هستند. اشتراک Felo Pro به‌طور خودکار اعتبارات خدمات API را اعطا نمی‌کند، و اعتبارات خدمات API هم اعتبارات اشتراک Felo Pro را اضافه نمی‌کنند.

## مرتبط

- [Felo Search API](https://openapi.felo.ai/fa/docs/api-reference/chat.md)
- [صورتحساب و اعتبارات](https://openapi.felo.ai/fa/docs/faq/billing-and-credits.md)
- [خطاها، محدودیت‌ها و تلاش‌های مجدد](https://openapi.felo.ai/fa/docs/guides/errors-and-limits.md)
- [Console Billing](https://openapi.felo.ai/console/billing)