शुरुआत
शुरुआत करें
API key पाएं, AI टूल चुनें, उसकी सेटअप गाइड खोलें और अपना पहला वर्कफ़्लो API कॉल चलाएं।
Felo API Platform आपको agent टूल, मॉडल प्रोटोकॉल, Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page और SuperAgent API के लिए एक ही key देता है। यहां से शुरू करें, अपना टूल चुनें और फिर उस टूल की समर्पित सेटअप गाइड का पालन करें।
यहां नए हैं? Platform Overview पढ़ें ताकि समझ सकें कि Model API, Data API और Felo API आपस में कैसे जुड़ते हैं, या सीधे Protocols and SDKs और Channels and Provider Routing पर जाएं।
CLI से Codex या Claude Code कॉन्फ़िगर करें
Node.js 22+ और अपना AI टूल इंस्टॉल होने के बाद यह चलाएं:
npx feloapi-cli setupप्रॉम्प्ट का पालन करते हुए अपनी पूरी Felo API key पेस्ट करें और मॉडल, Skills या दोनों चुनें। फिर अपना टूल npx feloapi-cli run codex या npx feloapi-cli run claude-code से शुरू करें।
त्वरित शुरुआत का क्रम
- Felo API Platform key प्राप्त करें और ज़रूरत पड़ने पर सेवा क्रेडिट खरीदें; किसी सदस्यता की ज़रूरत नहीं है।
- नीचे दी गई तालिका से अपना AI टूल या प्लेटफ़ॉर्म चुनें।
- उससे मेल खाती सेटअप गाइड खोलें और Felo base URL तथा API key पेस्ट करें।
- कनेक्शन की पुष्टि के लिए उस टूल में कोई छोटा काम चलाएं।
- जब आपके agent को सर्च, ऑफ़िस आउटपुट, वेब एक्सट्रैक्शन, इमेज वर्कफ़्लो, LiveDocs या SuperAgent की ज़रूरत हो, तब वर्कफ़्लो API जोड़ें।
चरण 1: अपनी API key प्राप्त करें
Felo API Platform सीधे API कॉल और समर्थित AI टूल में एक ही API key इस्तेमाल करता है।
- Felo API Platform API Keys पेज खोलें।
- अगर कहा जाए तो अपने Felo खाते से साइन इन करें।
- key का नाम दर्ज करें और Create Key पर क्लिक करें।
- key दिखने पर पूरी key कॉपी करें। यह केवल एक बार दिखाई जाती है।
- key को सुरक्षित रखें और इसे
FELO_API_KEYके रूप में इस्तेमाल करें।
Console Billing में $1 से शुरू करके ज़रूरत के अनुसार टॉप अप करें। आप वास्तविक API उपयोग के लिए USD में सेवा क्रेडिट खरीदते हैं। किसी सदस्यता की ज़रूरत नहीं है।
key को environment variable के रूप में सेट करें:
export FELO_API_KEY="YOUR_API_KEY"Windows PowerShell:
$env:FELO_API_KEY="YOUR_API_KEY"चरण 2: अपना AI टूल चुनें
जिस टूल का उपयोग करना चाहते हैं उस पर क्लिक करें। हर लिंक सही base URL, environment variable और सत्यापन चरण के साथ समर्पित सेटअप गाइड खोलता है।
| टूल | किसके लिए सर्वोत्तम | सेटअप गाइड |
|---|---|---|
| Codex | CLI कोडिंग वर्कफ़्लो, कोड समीक्षा, रेपो बदलाव और ऑटोमेशन | Codex सेट करें |
| Claude Code | Agent कोडिंग, रेपो संपादन, शोध-सहायता प्राप्त विकास और लंबे कॉन्टेक्स्ट वाला काम | Claude Code सेट करें |
| OpenCode | टर्मिनल कोडिंग सेशन और OpenAI-संगत प्रदाता रूटिंग | OpenCode सेट करें |
| OpenClaw | व्यक्तिगत AI सहायक वर्कफ़्लो और लोकल agent | OpenClaw सेट करें |
| Hermes Agent | Agent प्रयोग और मल्टी-टूल ऑर्केस्ट्रेशन | Hermes Agent सेट करें |
| TRAE | AI IDE वर्कफ़्लो और सहायता प्राप्त संपादन | TRAE सेट करें |
| OpenViking | Agent प्रयोग और प्रदाता बदलना | OpenViking सेट करें |
| Cursor | एडिटर के अंदर AI कोडिंग | Cursor सेट करें |
| Cline | VS Code agent वर्कफ़्लो और टर्मिनल-सहायता प्राप्त कोडिंग | Cline सेट करें |
| Roo Code | VS Code कोडिंग agent और कार्य योजना | Roo Code सेट करें |
| Kilo Code | लोकल कोडिंग agent और मॉडल-प्रदाता परीक्षण | Kilo Code सेट करें |
| अन्य AI टूल | कोई भी क्लाइंट जो कस्टम API key, base URL और मॉडल नाम स्वीकार करता हो | अन्य टूल सेट करें |
चरण 3: सही base URL का उपयोग करें
अधिकतर टूल तीन मान मांगते हैं: API key, base URL और मॉडल नाम। जिस प्रोटोकॉल का टूल समर्थन करता है, उसके आधार पर base URL चुनें।
| टूल जो मांगता है | यह मान इस्तेमाल करें |
|---|---|
| API key | आपकी FELO_API_KEY |
| OpenAI-संगत base URL | https://openapi.felo.ai/api/v1 |
| Anthropic-संगत base URL | https://openapi.felo.ai/api |
| मॉडल ID | मॉडल कैटलॉग से वर्तमान में उपलब्ध कोई ID चुनें |
अगर आपको पता नहीं कि आपका क्लाइंट किस मोड का समर्थन करता है, तो OpenAI-संगत base URL से शुरू करें। Claude Code या उन क्लाइंट के लिए Anthropic-संगत base URL इस्तेमाल करें जो स्पष्ट रूप से Anthropic Messages endpoint मांगते हैं।
चरण 4: सीधे API कॉल से सत्यापित करें
अगर आपको केवल यह पुष्टि करनी है कि आपकी key काम करती है, तो Chat API को सीधे कॉल करें।
curl -X POST https://openapi.felo.ai/v2/chat \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "Research the latest AI agent product trends"
}'सफल प्रतिक्रिया में एक उत्तर, क्वेरी विश्लेषण और वेब संसाधन शामिल होते हैं।
{
"status": "ok",
"data": {
"id": "HabCj883yHLSXc8mWqu4Eq",
"message_id": "18ea8517-5559-4f48-a355-1f8a79e73b71",
"answer": "...",
"query_analysis": {
"queries": ["AI agent product trends"]
},
"resources": [
{
"link": "https://example.com/report",
"title": "AI Agent Market Report",
"snippet": "..."
}
]
}
}चरण 5: वर्कफ़्लो API जोड़ें
आपका पहला टूल या API कॉल काम करने के बाद, अपनी परिस्थिति से मेल खाने वाली API जोड़ें।
| परिस्थिति | अनुशंसित API | दस्तावेज़ |
|---|---|---|
| सर्च और शोध agent | Chat, Web Fetch, X Search, YouTube Subtitling, LiveDocs | Chat API |
| ऑफ़िस उत्पादकता agent | PPT Task, Mindmap, LiveDocs, SuperAgent | PPT Task API |
| क्रिएटिव ऑपरेशन agent | Landing Page, Image वर्कफ़्लो, Web Fetch, Search, SuperAgent | Landing Page API |
| फ़ुल-स्टैक AI ऐप | LLM API, Chat, LiveDocs, Web Fetch, SuperAgent | LLM API |
| नॉलेज वर्कफ़्लो | LiveDocs, Web Fetch, Chat, SuperAgent | LiveDoc API |
सीधे API के उदाहरण
अगर आप AI टूल कॉन्फ़िगर करने के बजाय सीधे API के साथ काम बना रहे हैं, तो इनमें से किसी न्यूनतम कॉल से शुरू करें।
PPT कार्य बनाएं
जब आप असिंक्रोनस रूप से स्लाइड डेक बनाना चाहते हैं तो PPT Task API का उपयोग करें। प्रतिक्रिया में एक task_id मिलता है जिसे आप पोल कर सकते हैं।
curl -X POST https://openapi.felo.ai/v2/ppts \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "Create a 5-slide strategy deck about AI agents for office productivity"
}'उदाहरण प्रतिक्रिया:
{
"status": "ok",
"message": null,
"data": {
"task_id": "019cad6d-e874-55ef-d577-686344b5a7e9",
"livedoc_short_id": "PvyKouzJirXjFdst4uKRK3",
"ppt_business_id": "BfLPuQKmChk9SPmyQawxgr"
}
}कार्य की स्थिति पोल करें:
curl -X GET https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status \
-H "Authorization: Bearer $FELO_API_KEY"Landing Page कार्य बनाएं
जब आप चाहते हैं कि Felo किसी प्रॉम्प्ट से landing page बनाए, तो Landing Page Task API का उपयोग करें।
curl -X POST https://openapi.felo.ai/v2/landing_page \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "Generate a launch landing page for an AI research assistant"
}'उदाहरण प्रतिक्रिया:
{
"status": "ok",
"message": null,
"data": {
"task_id": "019cad6d-e874-55ef-d577-686344b5a7e9",
"thread_short_id": "9qiLTmT77fA3aVurrMHvRJ"
}
}PPT कार्यों वाले उसी कार्य-स्थिति endpoint को पोल करें:
curl -X GET https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status \
-H "Authorization: Bearer $FELO_API_KEY"Python
import os
import requests
api_key = os.environ["FELO_API_KEY"]
response = requests.post(
"https://openapi.felo.ai/v2/chat",
headers={
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json",
},
json={"query": "What are the latest AI agent product trends?"},
timeout=60,
)
response.raise_for_status()
print(response.json()["data"]["answer"])JavaScript (Node.js)
const response = await fetch("https://openapi.felo.ai/v2/chat", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.FELO_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
query: "What are the latest AI agent product trends?",
}),
});
if (!response.ok) {
throw new Error(`Felo API request failed: ${response.status}`);
}
const result = await response.json();
console.log(result.data.answer);सेटअप की सामान्य समस्याएं
| समस्या | क्या जांचें |
|---|---|
UNAUTHORIZED | पुष्टि करें कि key सही कॉपी हुई है, रद्द नहीं हुई है और Authorization: Bearer $FELO_API_KEY के रूप में भेजी जा रही है |
| टूल गलत प्रदाता को कॉल करता है | जांचें कि वर्तमान workspace या सेशन में Felo प्रदाता चुना गया है |
| OpenAI-संगत क्लाइंट विफल होता है | base URL के रूप में https://openapi.felo.ai/api/v1 इस्तेमाल करें |
| Anthropic-संगत क्लाइंट विफल होता है | base URL के रूप में https://openapi.felo.ai/api इस्तेमाल करें |
| असिंक्रोनस कार्य का परिणाम अभी नहीं है | कार्य पूरा होने तक कार्य-स्थिति endpoint को पोल करें |