मिस्ट्रल API इंटीग्रेशन गाइड

स्टैंडर्ड मिस्ट्रल API से क्यों स्विच करें?

डेवलपर्स अक्सर ऐसे कंटेंट फिल्टर्स से टकराते हैं जो उनकी वर्कफ़्लो में बाधा डालते हैं। मानक API विशिष्ट विषयों को अस्वीकार कर देते हैं। हमारा अनसेंसर्ड मॉडल सीधे जवाब देता है। आप अपने आउटपुट पर पूर्ण नियंत्रण रखते हैं।

मानक Mistral API विश्वसनीय है। यह लोकप्रिय मॉडल सेवाएं प्रदान करता है। हालांकि, यह अपनी मॉडरेशन परतें लागू करता है। आप रचनात्मक लेखन या वयक्त विषयों के लिए अस्वीकृतियां देख सकते हैं। हमारी API उन बाधाओं को हटा देती है। यह कम प्रतिबंधों के लिए ट्यून्ड एक ओपन-वेट मॉडल चलाती है। आपको वही OpenAI-संगत एंडपॉइंट मिलता है।

लागत एक अन्य कारक है। मानक योजनाएं अक्सर आपको सब्सक्रिप्शन में बांधती हैं। हम पूर्वभुगतान क्रेडिट प्रणाली का उपयोग करते हैं। आप केवल उसी के लिए भुगतान करते हैं जिसका आप उपयोग करते हैं। त्रुटियों से आपको टोकन नहीं लगते। यह पारदर्शिता आपको सटीक बजट बनाने में मदद करती है।

माइग्रेशन नगण्य है। आपका मौजूदा कोड काम करता है। आप केवल बेस URL बदलते हैं। जटिल रीराइट की आवश्यकता नहीं है। यह लचीलापन उन डेवलपर्स के लिए उपयुक्त है जो स्थानीय मॉडल्स को प्रबंधित किए बिना अनसेंसर्ड जनरेशन चाहते हैं।

चरण 1: अपना API Key प्राप्त करें

हमारे प्लेटफ़ॉर्म पर एक खाता बनाकर शुरू करें। आप Google के साथ साइन इन कर सकते हैं या एक ईमेल और पासवर्ड का उपयोग कर सकते हैं। फ़ोन नंबर की आवश्यकता नहीं है। इससे आपकी पहचान गोपनीय रहती है।

लॉगिन करने के बाद, डैशबोर्ड पर जाएं। तुरंत अपनी API कुंजी जनरेट करें। कुंजी केवल एक बार दिखाई जाती है। इसे कॉपी करें और सुरक्षित रूप से संग्रहीत करें। आपको हर अनुरोध के लिए इसकी आवश्यकता होगी।

आपको स्वचालित रूप से ट्रायल क्रेडिट प्राप्त होता है। नए खातों को सात दिनों के लिए वैध $0.50 मिलते हैं। यह आपको फंड्स निवेश करने से पहले इंटीग्रेशन का परीक्षण करने की अनुमति देता है।

आपकी कुंजी की विशिष्ट सीमाएं हैं। आप प्रति मिनट 300 अनुरोध कर सकते हैं। केवल आठ अनुरोध एक साथ चलते हैं। प्रत्येक कुंजी आपके खाते के लिए विशिष्ट होती है। यदि आप एक नई कुंजी जनरेट करते हैं, तो पुरानी कुंजी काम करना बंद कर देती है। यह आपके क्रेडिट्स तक सुरक्षित पहुंच को सुनिश्चित करता है।

चरण 2: अपना बेस URL कॉन्फ़िगर करें

बेस URL एकल सबसे महत्वपूर्ण परिवर्तन है। अपने SDK को हमारे एंडपॉइंट पर इशारा करें। मानक OpenAI प्रारूप का उपयोग करें। यह आपके मौजूदा लाइब्रेरी के साथ संगतता सुनिश्चित करता है।

अपना बेस URL HTTPS://api.mistralbaseurl.com/v1 पर सेट करें। यह पथ प्रमुख प्रदाताओं की संरचना को दर्शाता है। आपका कोड एंडपॉइंट्स को सही ढंग से पहचान लेगा। आपको नए ड्राइवर या क्लाइंट की आवश्यकता नहीं होगी।

अपने कोड में API कुंशी वेरिएबल अपडेट करें। पुराने प्रदाता कुंशी को अपनी नई कुंशी से बदलें। सुनिश्चित करें कि कुंशी स्ट्रिंग सही है। टाइपो तुरंत प्रमाणीकरण त्रुटियों का कारण बनते हैं।

सरल पिंग के साथ कनेक्शन का परीक्षण करें। उपलब्ध मॉडलों की सूची का अनुरोध करें। आपको हमारा अनसेंसर्ड मॉडल सूचीबद्ध मिलना चाहिए। यह पुष्टि करता है कि आपकी कॉन्फ़िगरेशन सही है। अब आप प्रॉम्प्ट भेजने के लिए तैयार हैं।

चरण 3: चैट पूरक लागू करें

चैट कंप्लीशन्स एंडपॉइंट पर एक POST रिक्वेस्ट भेजें। मॉडल आईडी "uncensored" का उपयोग करें। यह हमारे विशिष्ट बड़े लैंग्वेज मॉडल को ट्रिगर करता है। यह आपके इनपुट को प्रोसेस करता है और टेक्स्ट जनरेट करता है।

अपने संदेशों को एक सरणी के रूप में संरचित करें। सिस्टम, उपयोगकर्ता और सहायक भूमिकाएं शामिल करें। मॉडल इन निर्देशों का कड़ाई से पालन करता है। आप तापमान और top_p जैसे पैरामीटर सेट कर सकते हैं। ये आउटपुट की रचनात्मकता को नियंत्रित करते हैं।

संदर्भ विंडो 100,000 टोकन की है। इससे लंबे दस्तावेज़ संभाले जा सकते हैं। आप एक ही अनुरोध में व्यापक संदर्भ भेज सकते हैं। मॉडल लंबे क्रम में सहसंबद्धता बनाए रखता है। यह कोड विश्लेषण या सारांश के लिए उपयोगी है।

अधिकतम आउटपुट 16,000 टोकन है। यदि आप max_tokens सेट नहीं करते हैं, तो सीमा 2,048 है। अपनी आवश्यकताओं के आधार पर इस पैरामीटर को समायोजित करें। लंबी प्रतिक्रियाओं में अधिक क्रेडिट की आवश्यकता होती है। अपनी टोकन बजट की योजना उचित रूप से बनाएं।

स्ट्रीमिंग और टोकन्स हैंडल करना

स्ट्रीमिंग उपयोगकर्ता अनुभव को बेहतर बनाती है। यह टोकन को जनरेट होते हुए भेजती है। यह अनुपस्थित विलंबता को कम करती है। अपने SDK सेटिंग्स में स्ट्रीमिंग सक्षम करें।

हम Server-Sent Events (SSE) का उपयोग करते हैं। स्ट्रीम टेक्स्ट के चंक प्रदान करती है। प्रत्येक चंक में प्रतिक्रिया का एक हिस्सा होता है। आप टोकन को रियल-टाइम में प्रदर्शित कर सकते हैं।

टोकन उपयोग अंतिम चंक में रिपोर्ट किया जाता है। इससे बिलिंग सटीक होती है। आप देखते हैं कि वास्तव में क्या खपत हुआ। त्रुटियों के लिए आपको शुल्क नहीं लगता। अस्वीकृतियां मुफ्त हैं। यह आपके बजट को बर्बाद अनुरोधों से बचाता है।

अपने क्रेडिट बैलेंस की नियमित रूप से निगरानी करें। आप किसी भी समय क्रिप्टो के माध्यम से टॉप अप कर सकते हैं। क्रेडिट कभी समाप्त नहीं होते हैं। इससे आपको बिना किसी दंड के उपयोग रोकने की अनुमति मिलती है। आप अपनी शेष राशि को अनिश्चित काल तक बनाए रखते हैं।

फंक्शन कॉलिंग और JSON मोड

हमारा API संरचित आउटपुट का समर्थन करता है। आप JSON मोड को लागू कर सकते हैं। response_format को json_object पर सेट करें। मॉडल केवल मान्य JSON लौटाता है। यह एकीकरण के लिए महत्वपूर्ण है।

फंक्शन कॉलिंग निर्बाध रूप से काम करती है। अनुरोध में अपने टूल्स परिभाषित करें। मॉडल पहचानता है कि किस टूल का उपयोग करना है। यह तर्ग सही तरीके से पास करता है। आप अपने कोड में परिणाम को पार्स कर सकते हैं।

tool_choice को auto या विशिष्ट सेट करें। यह आपको व्यवहार पर नियंत्रण देता है। मॉडल आवश्यकता पड़ने पर टूल उपयोग को प्राथमिकता देता है। यह जटिल वर्कफ़्लो में विश्वसनीयता को बढ़ाता है।

डेटा एक्सट्रैक्शन के लिए इन सुविधाओं का उपयोग करें। फॉर्म या API कॉल को स्वचालित करें। अनसेंसर्ड मॉडल एज केसों को अच्छी तरह संभालता है। यह जटिल क्वेरीज को अस्वीकार नहीं करता है। यह उत्पादन कार्यों के लिए उपयुक्त बनाता है।

सामान्य त्रुटियाँ: 404 और 422 की व्याख्या

त्रुटियाँ आमतौर पर कॉन्फ़िगरेशन समस्याओं को दर्शाती हैं। एक 404 नोट फाउंड त्रुटि सामान्य है। इसका अर्थ है कि एंडपॉइंट गलत है। अपनी बेस यूआरएल को सावधानी से जांचें। सुनिश्चित करें कि आप पथ में /v1 शामिल करते हैं।

422 Unprocessable Entity त्रुटि होती है। यह अक्सर अमान्य JSON के साथ होता है। अपने अनुरोध बॉडी संरचना की जांच करें। सुनिश्चित करें कि सभी आवश्यक फ़ील्ड मौजूद हैं। मॉडल ID सही है, इसकी पुष्टि करें।

रेट लिमिट्स 429 त्रुटियां लौटाती हैं। आपने प्रति मिनट 300 अनुरोधों से अधिक किया है। रीट्राई करने से पहले थोड़ी प्रतीक्षा करें। अपने कोड में एक्सपोनेंशियल बैकऑफ लागू करें। यह API पर अत्यधिक भार डालने से बचाता है।

अपनी API कुंजी की वैधता की जाँच करें। सुनिश्चित करें कि यह समाप्त नहीं हुई है। कुंजियां यदि पुनः जनरेट की जाती हैं तो स्वचालित रूप से बदल जाती हैं। प्रत्येक अनुरोध के लिए सही कुंजी का उपयोग करें। यह डाउनटाइम को न्यूनतम करता है।

लागत तुलना: मिस्ट्रल बनाम हमारा अनसेंसर्ड API

हमारी कीमतें सरल हैं। आप मिलियन इनपुट टोकन के लिए $0.15 भुगतान करते हैं। आउटपुट टोकन की कीमत $0.50 प्रति मिलियन है। यह पारदर्शी और पूर्वानुमेय है।

मानक APIs अक्सर अधिक चार्ज करते हैं। उनमें प्लेटफ़ॉम शुल्क शामिल होते हैं। हमारा मॉडल हमारे सर्वर पर चलता है। आप सीधे कंप्यूट के लिए भुगतान करते हैं। यह बेस लागत को कम करता है।

त्रुटियाँ मुफ्त हैं। आप विफल अनुरोधों के लिए भुगतान नहीं करते। यह डिबगिंग पर पैसे बचाता है। आप केवल वैध आउटपुट के लिए भुगतान करते हैं।

टॉप-अप $20 से शुरू होते हैं। आप क्रिप्टो के साथ भुगतान करते हैं। बोनस क्रेडिट उपलब्ध हैं। $50 जोड़ें 5% अतिरिक्त के लिए। $100 जोड़ें 10% अतिरिक्त के लिए। $200 जोड़ें 15% अतिरिक्त के लिए। यह उच्च उपयोग के लिए पुरस्कार देता है।

मसल माइग्रेशन के लिए अंतिम चेकलिस्ट

पुष्टि करें कि आपका बेस यूआरएल सही है। अपने API कुंजी को पर्यावरण में अपडेट करें। एक सरल प्रॉम्प्ट के साथ परीक्षण करें। सुनिश्चित करें कि स्ट्रीमिंग यदि आवश्यक हो तो काम करता है।

अपनी रेट लिमिट हैंडलिंग की जांच करें। 429 त्रुटियों के लिए रेट्राइज़ लागू करें। अपने टोकन उपयोग की निगरानी करें। आवश्यकतानुसार max_tokens समायोजित करें।

संरचित डेटा के लिए जेएसओएन मोड सक्षम करें। अपने टूल्स के साथ फंक्शन कॉलिंग का परीक्षण करें। सुनिश्चित करें कि मॉडल सही प्रतिक्रिया देता है। सत्यापित करें कि आउटपुट फॉर्मेट आपकी अपेक्षाओं से मेल खाता है।

अपने पैरामीटर को अनुकूलित करें। रचनात्मकता के लिए तापमान सेट करें। विविधता के लिए top_p का उपयोग करें। ये सेटिंग्स आउटपुट गुणवत्ता को प्रभावित करती हैं। सर्वोत्तम संतुलन खोजने के लिए प्रयोग करें। आपका कोड URL और कुंजी के अलावा अपरिवर्तित रहना चाहिए।