Felo API सेटअप

Felo, Data API में एक provider है, जो वेब खोज, वेब रीडिंग, X डेटा, खोज-आधारित उत्तर और प्रस्तुतियाँ प्रदान करता है। प्रत्येक Felo endpoint को संबंधित Data API श्रेणी में अन्य providers के साथ पाएँ।

ये endpoints platform balance और /api/v1/data prefix का उपयोग करते हैं। यह guide 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 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 generate नहीं करता; उसके लिए Chat का उपयोग करें।

API को अन्वेषित करें

इन guides में कुल 14 core operations हैं। यदि PPT creation एक stream_key लौटाती है, तो PPT guide यह भी समझाती है कि SSE के साथ generation events कैसे पढ़ें। Status और result queries, export-status queries और deletion नया charge create नहीं करते।

मौजूदा एकीकरण को स्थानांतरित करने से पहले

जिस exact endpoint को आप call करते हैं, उसके guide का उपयोग करें। /v2 को /api/v1/data से बदल देना complete 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 दोनों save करें।
• 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 सार्वजनिक हैं और key के बिना पढ़े जा सकते हैं। Automatic retries जोड़ने से पहले Billing and Errors देखें।