# Felo API सेटअप

खोज, वेब सामग्री, X डेटा और प्रस्तुतियों के लिए Data API में Felo endpoint सेट करें, platform balance का उपयोग करते हुए।

Felo, [Data API](https://openapi.felo.ai/hi/docs/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](https://openapi.felo.ai/hi/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 requests को `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 एक `resources` array लौटाता है जिसमें page titles, links और snippets होते हैं, साथ में `total` भी। यह conversational answer generate नहीं करता; उसके लिए [Chat](https://openapi.felo.ai/hi/docs/data-api/guides/felo-chat.md) का उपयोग करें।

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

| मार्गदर्शिका | संचालन | आपको क्या मिलता है | बिलिंग इकाई |
| --- | --- | --- | --- |
| [वेब खोज](https://openapi.felo.ai/hi/docs/data-api/guides/felo-web-search.md) | वेब पर खोजें | पृष्ठ शीर्षक, लिंक और अंश | अनुरोध |
| [वेब पढ़ें](https://openapi.felo.ai/hi/docs/data-api/guides/felo-web-read.md) | एक URL पढ़ें | Markdown, पाठ, HTML या स्क्रीनशॉट | अनुरोध |
| [X डेटा](https://openapi.felo.ai/hi/docs/data-api/guides/felo-x-data.md) | प्रोफ़ाइल, उपयोगकर्ता खोज, उपयोगकर्ता पोस्ट, पोस्ट खोज, उत्तर | संरचित उपयोगकर्ता और पोस्ट, जहाँ समर्थित हो वहाँ पृष्ठांकन के साथ | लौटाया गया परिणाम |
| [खोज-आधारित चैट](https://openapi.felo.ai/hi/docs/data-api/guides/felo-chat.md) | एक प्रश्न का उत्तर दें | उत्तर और वेब स्रोत | अनुरोध |
| [PPT](https://openapi.felo.ai/hi/docs/data-api/guides/felo-ppt.md) | बनाएँ, स्थिति, परिणाम, निर्यात, निर्यात स्थिति, हटाएँ | जनरेशन कार्य और डाउनलोड करने योग्य PPTX | जनरेट किया गया पृष्ठ; निर्यात का बिल अलग से लगता है |
| [बिलिंग और त्रुटियाँ](https://openapi.felo.ai/hi/docs/data-api/guides/felo-billing.md) | साझा एकीकरण मार्गदर्शन | मूल्य, बैलेंस प्रबंधन और पुनःप्रयास नियम | — |

इन guides में कुल **14 core operations** हैं। यदि PPT creation एक `stream_key` लौटाती है, तो [PPT guide](https://openapi.felo.ai/hi/docs/data-api/guides/felo-ppt.md#sse) यह भी समझाती है कि 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](https://openapi.felo.ai/hi/docs/api-reference/felo-apis.md) और Pro-credit billing का उपयोग जारी रखें।

## अनुबंध और वर्तमान मूल्य

- [Published OpenAPI schema](https://openapi.felo.ai/api/v1/data/openapi.json) — field definitions और response schemas।
- [OpenAPI YAML schema](https://openapi.felo.ai/api/v1/data/openapi.yaml) — उन tools के लिए जो YAML स्वीकार करते हैं।
- [Current prices](https://openapi.felo.ai/api/v1/data/prices) — operation IDs, billing units और current rates।

ये resources सार्वजनिक हैं और key के बिना पढ़े जा सकते हैं। Automatic retries जोड़ने से पहले [Billing and Errors](https://openapi.felo.ai/hi/docs/data-api/guides/felo-billing.md) देखें।