Felo API سیٹ اپ

Felo، Data API میں ایک provider ہے، جو ویب تلاش، ویب مطالعہ، X ڈیٹا، تلاش پر مبنی جوابات اور پریزنٹیشنز فراہم کرتا ہے۔ ہر Felo endpoint کو متعلقہ Data API category میں دیگر providers کے ساتھ تلاش کریں۔

یہ endpoints 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 چیک کریں یا اس میں رقم شامل کریں۔
3. key کو اپنے server پر یا اپنے local shell میں سیٹ کریں:

export FELO_API_KEY="YOUR_API_KEY"

Authorization: Bearer $FELO_API_KEY بھیجیں۔ X-API-Key بھی قبول کیا جاتا ہے؛ authentication کا ایک طریقہ منتخب کریں۔ JSON requests کے لیے 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 array واپس کرتا ہے جس میں page titles، links اور snippets شامل ہوتے ہیں، ساتھ ہی total بھی۔ یہ conversational answer تیار نہیں کرتا؛ اس کے لیے Chat استعمال کریں۔

APIز دریافت کریں

ان guides میں 14 core operations موجود ہیں۔ اگر PPT creation ایک stream_key واپس کرے، تو PPT guide یہ بھی بتاتی ہے کہ SSE کے ساتھ generation events کیسے پڑھیں۔ Status اور result queries، export-status queries اور deletion نئی charge پیدا نہیں کرتے۔

موجودہ انضمام کو منتقل کرنے سے پہلے

جس endpoint کو آپ call کرتے ہیں، اسی کے لیے مخصوص guide استعمال کریں۔ /v2 کو /api/v1/data سے بدل دینا مکمل migration نہیں ہے:

• Web Read /web/read استعمال کرتا ہے، اور ہر request میں صرف ایک output format دیتا ہے۔
• Chat status: "ok" واپس کرتا ہے؛ یہ صرف non-streaming JSON کو support کرتا ہے۔
• PPT results میں POST /tasks/{task_id}/historical استعمال ہوتا ہے۔
• PPT creation JSON root پر identifiers واپس کرتی ہے۔ task_id اور ppt_business_id دونوں محفوظ کریں۔
• Generated PPTs سات دن بعد expire ہو جاتے ہیں۔ expiry سے پہلے اپنی file export اور save کر لیں۔

یہاں ہر /v2 workflow کے لیے native OpenAPI equivalent documented نہیں ہے، جیسے LiveDoc CRUD، Mindmap یا SuperAgent۔ ان کے لیے ان کی Felo APIs guides اور Pro-credit billing استعمال کرتے رہیں۔

معاہدہ اور موجودہ قیمتیں

• Published OpenAPI schema — field definitions اور response schemas۔
• OpenAPI YAML schema — ان tools کے لیے جو YAML قبول کرتے ہیں۔
• Current prices — operation IDs، billing units اور current rates۔

یہ resources public ہیں اور key کے بغیر پڑھے جا سکتے ہیں۔ automatic retries شامل کرنے سے پہلے Billing and Errors دیکھیں۔