Felo API PlatformFelo API Platform

गाइड

प्रोटोकॉल और SDK

OpenAI-compatible, Responses और Anthropic Messages प्रोटोकॉल इस्तेमाल करें, साथ में स्ट्रीमिंग, tool calls और माइग्रेशन।

Model API तीन wire प्रोटोकॉल बोलती है। अपना मौजूदा SDK रखें और base URL, API key तथा मॉडल ID बदलें।

Endpoint मैट्रिक्स

प्रोटोकॉलEndpointसामान्य क्लाइंट
OpenAI Chat CompletionsPOST https://openapi.felo.ai/api/v1/chat/completionsOpenAI SDK, अधिकतर OpenAI-संगत टूल
OpenAI ResponsesPOST https://openapi.felo.ai/api/v1/responsesResponses API सुविधाओं वाला OpenAI SDK
Anthropic MessagesPOST https://openapi.felo.ai/api/v1/messagesAnthropic SDK, Claude Code, Claude-नेटिव टूल

Base URL

क्लाइंटBase URLक्यों
OpenAI SDKhttps://openapi.felo.ai/api/v1SDK /chat/completions या /responses जोड़ता है
Anthropic SDKhttps://openapi.felo.ai/apiSDK /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 परिचित messages array और 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 से माइग्रेट करें

  1. base URL को मेल खाते Felo URL में बदलें।
  2. API key को FELO_API_KEY से बदलें।
  3. मॉडल नाम को सार्वजनिक Felo मॉडल ID से बदलें।
  4. अनुरोध का बाकी स्वरूप वैसा ही रखें।
लक्षणसंभावित कारण
हर अनुरोध पर 404base URL में पहले से /v1 है, या Anthropic base URL में मैन्युअल रूप से /v1 जोड़ा गया है
401Felo key गुम है या क्लाइंट अब भी पुरानी key भेज रहा है
400 model त्रुटिमॉडल ID सार्वजनिक नहीं है या चुने गए endpoint का समर्थन नहीं करता
Messages अनुरोध अस्वीकृतMessages प्रोटोकॉल के लिए max_tokens ज़रूरी है
Tool call अनदेखामॉडल उस क्षमता का दावा नहीं करता

संबंधित