गाइड
प्रोटोकॉल और SDK
OpenAI-compatible, Responses और Anthropic Messages प्रोटोकॉल इस्तेमाल करें, साथ में स्ट्रीमिंग, tool calls और माइग्रेशन।
Model API तीन wire प्रोटोकॉल बोलती है। अपना मौजूदा SDK रखें और base URL, API key तथा मॉडल ID बदलें।
Endpoint मैट्रिक्स
| प्रोटोकॉल | Endpoint | सामान्य क्लाइंट |
|---|---|---|
| OpenAI Chat Completions | POST https://openapi.felo.ai/api/v1/chat/completions | OpenAI SDK, अधिकतर OpenAI-संगत टूल |
| OpenAI Responses | POST https://openapi.felo.ai/api/v1/responses | Responses API सुविधाओं वाला OpenAI SDK |
| Anthropic Messages | POST https://openapi.felo.ai/api/v1/messages | Anthropic SDK, Claude Code, Claude-नेटिव टूल |
Base URL
| क्लाइंट | Base URL | क्यों |
|---|---|---|
| OpenAI SDK | https://openapi.felo.ai/api/v1 | SDK /chat/completions या /responses जोड़ता है |
| Anthropic SDK | https://openapi.felo.ai/api | SDK /v1/messages जोड़ता है; आप स्वयं /v1 न जोड़ें |
दोनों क्लाइंट आपकी Felo API key को SDK API key के रूप में उपयोग करते हैं।
import OpenAI from "openai";
import Anthropic from "@anthropic-ai/sdk";
const openai = new OpenAI({
apiKey: process.env.FELO_API_KEY,
baseURL: "https://openapi.felo.ai/api/v1",
});
const anthropic = new Anthropic({
apiKey: process.env.FELO_API_KEY,
baseURL: "https://openapi.felo.ai/api",
});प्रोटोकॉल चुनें
- Chat Completions का उपयोग करें जब आपका टूल या SDK परिचित
messagesarray औरchoices[0].message.contentकी अपेक्षा करता हो। - Responses का उपयोग करें जब आपको OpenAI का Responses ऑब्जेक्ट,
input,instructionsयाoutput_textचाहिए। - Messages का उपयोग करें जब आप Anthropic SDK या Claude-नेटिव टूल का उपयोग कर रहे हों।
हर प्रोटोकॉल के काम करने की धारणा बनाने से पहले मॉडल जांचें। कैटलॉग supported_protocols, supported_parameters और recommended_protocol दिखाता है। recommended_protocol क्लाइंट के लिए सिफ़ारिश है, प्रतिबंध नहीं; मॉडल अब भी कोई अन्य प्रोटोकॉल स्वीकार कर सकता है।
स्ट्रीमिंग
Server-Sent Events प्राप्त करने के लिए stream: true सेट करें।
- Chat Completions OpenAI-शैली के chat chunks भेजता है।
- Responses Responses SSE इवेंट भेजता है और पूर्ण response ऑब्जेक्ट के साथ समाप्त होता है।
- Messages Anthropic message stream इवेंट भेजता है।
इवेंट स्ट्रीम को क्रमशः पढ़ें और कनेक्शन बंद करने से पहले टर्मिनल इवेंट संभालें। टूटा हुआ कनेक्शन पूर्ण प्रतिक्रिया के समान नहीं है।
Tool calls और संरचित आउटपुट
tools को प्रोटोकॉल के मूल स्वरूप में पास करें। समर्थन मॉडल के अनुसार बदलता है, इसलिए tool calls, JSON mode या संरचित आउटपुट पर निर्भर होने से पहले कैटलॉग में supported_parameters जांचें। मॉडल फ़ील्ड स्वीकार कर सकता है और फिर भी असमर्थित विकल्प को अनदेखा कर सकता है।
चैनल रूटिंग
जब आपको किसी प्रदाता को पिन करना हो तो तीनों endpoint X-Felo-Channel स्वीकार करते हैं। हेडर नियम और उदाहरणों के लिए Channels and Provider Routing देखें।
आधिकारिक API से माइग्रेट करें
- base URL को मेल खाते Felo URL में बदलें।
- API key को
FELO_API_KEYसे बदलें। - मॉडल नाम को सार्वजनिक Felo मॉडल ID से बदलें।
- अनुरोध का बाकी स्वरूप वैसा ही रखें।
| लक्षण | संभावित कारण |
|---|---|
| हर अनुरोध पर 404 | base URL में पहले से /v1 है, या Anthropic base URL में मैन्युअल रूप से /v1 जोड़ा गया है |
| 401 | Felo key गुम है या क्लाइंट अब भी पुरानी key भेज रहा है |
400 model त्रुटि | मॉडल ID सार्वजनिक नहीं है या चुने गए endpoint का समर्थन नहीं करता |
| Messages अनुरोध अस्वीकृत | Messages प्रोटोकॉल के लिए max_tokens ज़रूरी है |
| Tool call अनदेखा | मॉडल उस क्षमता का दावा नहीं करता |