प्रमाणीकरण
किसी भी एनीइंट एपीआई कुंजी के साथ सुरक्षित रूप से प्रत्येक समर्थित एपीआई प्रोटोकॉल को प्रमाणित करें।
प्रत्येक डेवलपर एपीआई अनुरोध के लिए एक सक्रिय एनीइंट एपीआई कुंजी की आवश्यकता होती है। अपने क्लाइंट प्रोटोकॉल द्वारा अपेक्षित हेडर का उपयोग करें ताकि मौजूदा ओपनएआई, एन्थ्रोपिक और जेमिनी एसडीके काम करना जारी रख सकें।
प्रोटोकॉल द्वारा अनुशंसित प्रमाणीकरण
| प्रोटोकॉल | अनुशंसित इनपुट | मानक एपीआई आधार |
|---|---|---|
| ओपनएआई संगत | Authorization: Bearer <AnyInt API Key> | https://api.anyint.ai/openai/v1 |
| एन्थ्रोपिक संदेश | x-api-key: <AnyInt API Key> | https://api.anyint.ai/anthropic/v1 |
| जेमिनी डेवलपर एपीआई | x-goog-api-key: <AnyInt API Key> | https://api.anyint.ai/gemini/v1beta |
| एसिंक मीडिया | Authorization: Bearer <AnyInt API Key> | https://api.anyint.ai/v1/async-tasks |
क्लाइंट संगतता के लिए, गेटवे प्रोटोकॉल परिवारों में समर्थित एनीइंट कुंजी हेडर को भी स्वीकार करता है और जेमिनी मार्गों पर जेमिनी के key क्वेरी पैरामीटर को स्वीकार करता है। हेडर को प्राथमिकता दें ताकि क्रेडेंशियल यूआरएल या मध्यवर्ती लॉग में दिखाई न दें।
गेटवे प्रदाता रूटिंग से पहले एनीइंट क्रेडेंशियल का उपभोग करता है। यह कभी भी उस क्रेडेंशियल को अपस्ट्रीम प्रदाता कुंजी के रूप में अग्रेषित नहीं करता है। अमान्य, समाप्त या निरस्त की गई कुंजियाँ बंद हो जाती हैं।
कुंजी बनाएँ
कंसोल में एपीआई कुंजी बनाएँ, फिर इसे सर्वर-साइड सीक्रेट मैनेजर या पर्यावरण चर में स्टोर करें।
नए जारी किए गए एनीइंट कुंजियाँ 52 बेस64यूआरएल वर्णों (कुल 55 वर्ण) के बाद sk- उपसर्ग का उपयोग करती हैं। मौजूदा ak_ कुंजियाँ तब तक मान्य रहती हैं जब तक आप उन्हें घुमाते या अक्षम नहीं करते। कंसोल द्वारा दिखाए गए पूर्ण मान को हमेशा कॉपी करें; स्वयं कोई उपसर्ग न जोड़ें या हटाएं नहीं।
export ANYINT_API_KEY="your_api_key"सुरक्षा दिशानिर्देश
- कुंजियों को सर्वर-साइड सीक्रेट मैनेजर या पर्यावरण चर में स्टोर करें।
- कभी भी कुंजी को फ्रंटएंड जावास्क्रिप्ट, स्रोत नियंत्रण, लॉग या यूआरएल में न रखें।
- प्रत्येक एप्लिकेशन और पर्यावरण के लिए एक अलग कुंजी का उपयोग करें।
- यदि कोई कुंजी उजागर हो गई हो तो उसे तुरंत घुमाएँ।
- एनीइंट कुंजियों को अपस्ट्रीम प्रदाताओं को अग्रेषित न करें।
प्रमाणीकरण का परीक्षण करें
अनुमान अनुरोध भेजने से पहले कुंजी को सत्यापित करने के लिए मॉडल सूचीबद्ध करें।
curl "https://api.anyint.ai/openai/v1/models" \
--header "Authorization: Bearer $ANYINT_API_KEY"प्रमाणीकरण विफलता HTTP 401 को प्रोटोकॉल-आकार की त्रुटि के साथ लौटाती है। एक वैध कुंजी अभी भी अपर्याप्त शेष राशि के लिए 402 या जब कोई योग्य प्रदाता उपलब्ध नहीं होता है तो 503 प्राप्त कर सकती है।
सामान्य त्रुटि निवारण
जब कोई API अनुरोध विफल हो जाता है, तो कारण और समाधान तुरंत पहचानने के लिए इस तालिका का उपयोग करें:
| HTTP स्थिति | सामान्य कारण | समस्या निवारण और समाधान |
|---|---|---|
| 401 Unauthorized | अमान्य या समाप्त API कुंजी, या गुम हेडर | अपने Bearer टोकन या x-api-key हेडर की पुष्टि करें; सुनिश्चित करें कि कुंजी कंसोल API कुंजियाँ में सक्रिय है। |
| 402 Payment Required | अपर्याप्त शेष राशि या मासिक बजट सीमा पूरी हो गई | कंसोल में क्रेडिट जोड़ें या API कुंजी के लिए मासिक बजट सीमा बढ़ाएं। |
| 403 Forbidden | IP प्रतिबंध, वातावरण बेमेल, या अपर्याप्त अनुमतियां | अपनी API कुंजी का दायरा जांचें और स्वीकृत IP सूची के विरुद्ध अपने क्लाइंट IP की पुष्टि करें। |
| 404 Not Found | गलत एंडपॉइंट पथ या अज्ञात मॉडल ID | Base URL पथ की पुष्टि करें; मॉडल ID सक्रिय होने की पुष्टि के लिए GET /v1/models को कॉल करें। |
| 429 Too Many Requests | दर सीमा (RPM/TPM) या समवर्ती सीमा पूरी हो गई | समवर्तीता कम करें; घातीय बैकऑफ़ पुनः प्रयास कॉन्फ़िगर करें; या कंसोल में कोटा वृद्धि का अनुरोध करें। |
| 502 Bad Gateway | अपस्ट्रीम प्रदाता नेटवर्क त्रुटि या विकृत प्रतिक्रिया | AnyInt गेटवे स्वचालित रूप से चैनलों में फ़ेलओवर का प्रयास करता है; यदि समस्या बनी रहती है, तो कंसोल अनुरोध लॉग के माध्यम से रिपोर्ट करें। |
| 503 Service Unavailable | सभी रूटिंग उम्मीदवार चैनल अस्थायी रूप से अनुपलब्ध हैं | संक्षिप्त अंतराल के बाद पुनः प्रयास करें या किसी समकक्ष बैकअप मॉडल पर स्विच करें। |
| 504 Gateway Timeout | अपस्ट्रीम अनुमान समय समाप्त (जटिल तर्क मॉडल) | प्रॉम्प्ट जटिलता जांचें; क्लाइंट-साइड टाइमआउट बढ़ाएं; तर्क मॉडल के लिए स्ट्रीमिंग (stream: true) सक्षम करें। |