راه‌اندازی Felo API
ارائه‌دهنده: Felo · پرداخت با موجودی پلتفرم
Felo یکی از ارائه‌دهندگان در Data API است و جستجوی وب، خواندن وب، داده‌های X، پاسخ‌های مبتنی بر جستجو و ارائه‌ها را ارائه می‌دهد. هر پایان‌نقطه Felo را در کنار سایر ارائه‌دهندگان در دسته‌بندی مربوطه در Data API پیدا کنید.
این پایان‌نقطه‌ها از موجودی پلتفرم و پیشوند /api/v1/data استفاده می‌کنند. این راهنما احراز هویت، اولین درخواست شما و محل یافتن قوانین صورتحساب را توضیح می‌دهد.
برای استفاده از اعتبارات Felo Pro، به APIهای موجود Felo مراجعه کنید. موجودی پلتفرم و اعتبارات Pro جدا هستند.
اولین درخواست خود را انجام دهید
- یک کلید در Console → API Keys ایجاد کنید.
- موجودی پلتفرم خود را در Console → Billing بررسی یا شارژ کنید.
- کلید را روی سرور خود یا در پوسته محلی‌تان تنظیم کنید:
export FELO_API_KEY="YOUR_API_KEY"Authorization: Bearer $FELO_API_KEY را ارسال کنید. X-API-Key نیز پذیرفته می‌شود؛ یکی از روش‌های احراز هویت را انتخاب کنید. درخواست‌های JSON به 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 یک آرایه resources شامل عنوان‌های صفحه، پیوندها و گزیده‌ها، به‌همراه total را برمی‌گرداند. این کار یک پاسخ محاوره‌ای تولید نمی‌کند؛ برای آن از Chat استفاده کنید.
APIها را بررسی کنید
| راهنما | عملیات | آنچه دریافت می‌کنید | واحد صورتحساب |
|---|---|---|---|
| جستجوی وب | جستجوی وب | عنوان‌های صفحه، پیوندها و گزیده‌ها | درخواست |
| خواندن وب | خواندن یک URL | Markdown، متن، HTML یا تصویر صفحه | درخواست |
| داده‌های X | پروفایل‌ها، جستجوی کاربر، پست‌های کاربر، جستجوی پست، پاسخ‌ها | کاربران و پست‌های ساخت‌یافته، با صفحه‌بندی در صورت پشتیبانی | نتیجه بازگردانده‌شده |
| گفت‌وگوی مبتنی بر جستجو | پاسخ به یک پرسش | پاسخ و منابع وب | درخواست |
| PPT | ایجاد، وضعیت، نتایج، خروجی، وضعیت خروجی، حذف | وظیفه تولید و PPTX قابل دانلود | صفحه تولیدشده؛ خروجی جداگانه صورتحساب می‌شود |
| صورتحساب و خطاها | راهنمای یکپارچه‌سازی مشترک | قیمت‌ها، مدیریت موجودی و قواعد تلاش مجدد | — |
در این راهنماها در مجموع 14 عملیات اصلی وجود دارد. اگر ایجاد PPT یک stream_key برگرداند، راهنمای PPT همچنین توضیح می‌دهد که چگونه رویدادهای تولید را با SSE بخوانید. پرس‌وجوهای وضعیت و نتیجه، پرس‌وجوهای وضعیت خروجی و حذف، هزینه جدیدی ایجاد نمی‌کنند.
پیش از انتقال یک یکپارچه‌سازی موجود
از راهنمای دقیق همان پایانی که فراخوانی می‌کنید استفاده کنید. جایگزینی /v2 با /api/v1/data یک مهاجرت کامل نیست:
- Web Read از
/web/readاستفاده می‌کند و در هر درخواست فقط یک قالب خروجی دارد. - Chat مقدار
status: "ok"برمی‌گرداند؛ فقط JSON غیرجریانی را پشتیبانی می‌کند. - نتایج PPT از POST
/tasks/{task_id}/historicalاستفاده می‌کنند. - ایجاد PPT شناسه‌ها را در ریشه JSON برمی‌گرداند. هر دو
task_idوppt_business_idرا ذخیره کنید. - PPTهای تولیدشده پس از هفت روز منقضی می‌شوند. فایل خود را پیش از انقضا خروجی بگیرید و ذخیره کنید.
برای هر گردش‌کار /v2، مانند CRUD LiveDoc، Mindmap یا SuperAgent، معادل بومی OpenAPI که در اینجا مستند شده باشد وجود ندارد. همچنان از راهنماهای APIهای Felo و صورتحساب اعتبارات Pro استفاده کنید.
قرارداد و قیمت‌های فعلی
- اسکیما OpenAPI منتشرشده — تعریف فیلدها و اسکیماهای پاسخ.
- اسکیما YAML OpenAPI — برای ابزارهایی که YAML را می‌پذیرند.
- قیمت‌های فعلی — شناسه‌های عملیات، واحدهای صورتحساب و نرخ‌های فعلی.
این منابع عمومی هستند و بدون کلید قابل خواندن‌اند. پیش از افزودن تلاش‌های مجدد خودکار، به صورتحساب و خطاها مراجعه کنید.