# Magpie

Magpie को Felo API Platform मॉडल का प्रवेश बिंदु बनाएँ ताकि लोकल गेटवे Codex, Claude Code और अन्य एजेंट को Felo मॉडल दे सके।

अगर आप Magpie इस्तेमाल करते हैं — मेन्यू बार ऐप जो लोकल गेटवे के ज़रिए सभी प्रोवाइडर के मॉडल एक ही सूची में इकट्ठा करता है — और उसमें Felo API Platform के मॉडल जोड़ना चाहते हैं, तो यह गाइड आपके लिए है। Magpie `127.0.0.1:3425` पर गेटवे चलाता है और हर एजेंट की कॉन्फ़िगरेशन बदल देता है ताकि वह उसी के ज़रिए कॉल करे, इसलिए एजेंट को Felo की कुंजी या पता कभी जानना ही नहीं पड़ता।

## शुरू करने से पहले

आपको Felo API Platform की एक कुंजी चाहिए। वही कुंजी मॉडल प्रोटोकॉल, एजेंट क्लाइंट और Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page तथा SuperAgent API — सबके लिए काम करती है।

```bash
export FELO_API_KEY="YOUR_API_KEY"
```

अगर Magpie इंस्टॉल नहीं है तो इंस्टॉल करें:

```bash
curl -fsSL https://usemagpie.ai/install.sh | sh
```

## Felo को प्रोवाइडर के रूप में जोड़ें

एक ही Felo कुंजी Chat Completions, Responses और Anthropic Messages — तीनों संभालती है। Magpie को वे सारे बेस दें जो वह इस्तेमाल कर सकता है:

```bash
magpie provider add felo \
  url=https://openapi.felo.ai/api/v1 \
  responses=https://openapi.felo.ai/api/v1 \
  anthropic=https://openapi.felo.ai/api \
  key="$FELO_API_KEY"
```

ऐप में **Providers → Add provider** भी वही जानकारी लेता है: नाम `felo`, कुंजी, और OpenAI-संगत बेस `https://openapi.felo.ai/api/v1`। Anthropic-संगत प्रोवाइडर के लिए `https://openapi.felo.ai/api` इस्तेमाल करें।

कुंजी सहेजते ही Magpie Felo से मॉडल की सूची माँगता है। वे हर एजेंट के चयनकर्ता में `felo/<model-id>` के रूप में दिखते हैं।

```bash
magpie provider models felo   # Felo की सूची फिर से लाएँ
magpie models                 # एजेंट क्या चुन सकते हैं, felo/<model> सहित
```

## एजेंट में Felo मॉडल चुनें

```bash
magpie claude felo/claude-sonnet-5-5
magpie codex felo/gpt-5.6-sol
```

आप **Agents** पेज से भी चुन सकते हैं। चूँकि Felo तीनों प्रोटोकॉल देता है, हर एजेंट अपना प्रोटोकॉल बनाए रखता है — Claude Code Anthropic Messages पर, Codex Responses पर — और दोनों Felo तक पहुँचते हैं।

## क्लाइंट फ़ील्ड

| फ़ील्ड | मान |
|-------|-------|
| प्रोवाइडर नाम / id | `felo` |
| OpenAI Chat Completions बेस | `https://openapi.felo.ai/api/v1` |
| OpenAI Responses बेस | `https://openapi.felo.ai/api/v1` |
| Anthropic Messages बेस | `https://openapi.felo.ai/api` |
| API कुंजी | आपकी `FELO_API_KEY` |
| मॉडल | `felo/claude-sonnet-5-5` |

## सेटअप जाँचें

```bash
magpie provider test felo
```

Magpie हर प्रोटोकॉल के लिए एक छोटी रिक्वेस्ट भेजता है और विलंब बताता है। इसके बाद `felo/` मॉडल चुने हुए एजेंट से कोई छोटा सवाल पूछें; जवाब आया तो एजेंट → Magpie गेटवे → Felo का रास्ता ठीक चल रहा है।

## समस्या निवारण

| समस्या | क्या जाँचें |
|-------|---------------|
| `felo` के नीचे कोई मॉडल नहीं | कुंजी जाँचें और `magpie provider models felo` चलाएँ |
| `Model not found` | `felo/<model-id>` ठीक वैसे लिखें जैसे `magpie models` दिखाता है |
| प्रमाणीकरण विफल | `magpie provider key felo <key>` से कुंजी फिर दर्ज करें |
| Anthropic कॉल विफल | बेस `https://openapi.felo.ai/api` होना चाहिए, `/v1` के बिना |
| Codex मॉडल अनदेखा करता है | Codex को दोबारा चालू करें; वह शुरू होते समय मॉडल सूची पढ़ता है |

## अगले कदम

- [शुरुआत करें](https://openapi.felo.ai/hi/docs/getting-started.md)
- [LLM API संदर्भ](https://openapi.felo.ai/hi/docs/guides/protocols.md)
- [मॉडल और कीमतें](https://openapi.felo.ai/hi/docs/guides/models-and-pricing.md)
- [समस्या निवारण](https://openapi.felo.ai/hi/docs/faq/troubleshooting.md)
