प्रमाणीकरण

किसी भी एनीइंट एपीआई कुंजी के साथ सुरक्षित रूप से प्रत्येक समर्थित एपीआई प्रोटोकॉल को प्रमाणित करें।

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

प्रोटोकॉल द्वारा अनुशंसित प्रमाणीकरण

प्रोटोकॉलअनुशंसित इनपुटमानक एपीआई आधार
ओपनएआई संगत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_ कुंजियाँ तब तक मान्य रहती हैं जब तक आप उन्हें घुमाते या अक्षम नहीं करते। कंसोल द्वारा दिखाए गए पूर्ण मान को हमेशा कॉपी करें; स्वयं कोई उपसर्ग न जोड़ें या हटाएं नहीं।

bash
export ANYINT_API_KEY="your_api_key"

सुरक्षा दिशानिर्देश

  • कुंजियों को सर्वर-साइड सीक्रेट मैनेजर या पर्यावरण चर में स्टोर करें।
  • कभी भी कुंजी को फ्रंटएंड जावास्क्रिप्ट, स्रोत नियंत्रण, लॉग या यूआरएल में न रखें।
  • प्रत्येक एप्लिकेशन और पर्यावरण के लिए एक अलग कुंजी का उपयोग करें।
  • यदि कोई कुंजी उजागर हो गई हो तो उसे तुरंत घुमाएँ।
  • एनीइंट कुंजियों को अपस्ट्रीम प्रदाताओं को अग्रेषित न करें।

प्रमाणीकरण का परीक्षण करें

अनुमान अनुरोध भेजने से पहले कुंजी को सत्यापित करने के लिए मॉडल सूचीबद्ध करें।

bash
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 ForbiddenIP प्रतिबंध, वातावरण बेमेल, या अपर्याप्त अनुमतियांअपनी API कुंजी का दायरा जांचें और स्वीकृत IP सूची के विरुद्ध अपने क्लाइंट IP की पुष्टि करें।
404 Not Foundगलत एंडपॉइंट पथ या अज्ञात मॉडल IDBase URL पथ की पुष्टि करें; मॉडल ID सक्रिय होने की पुष्टि के लिए GET /v1/models को कॉल करें।
429 Too Many Requestsदर सीमा (RPM/TPM) या समवर्ती सीमा पूरी हो गईसमवर्तीता कम करें; घातीय बैकऑफ़ पुनः प्रयास कॉन्फ़िगर करें; या कंसोल में कोटा वृद्धि का अनुरोध करें।
502 Bad Gatewayअपस्ट्रीम प्रदाता नेटवर्क त्रुटि या विकृत प्रतिक्रियाAnyInt गेटवे स्वचालित रूप से चैनलों में फ़ेलओवर का प्रयास करता है; यदि समस्या बनी रहती है, तो कंसोल अनुरोध लॉग के माध्यम से रिपोर्ट करें।
503 Service Unavailableसभी रूटिंग उम्मीदवार चैनल अस्थायी रूप से अनुपलब्ध हैंसंक्षिप्त अंतराल के बाद पुनः प्रयास करें या किसी समकक्ष बैकअप मॉडल पर स्विच करें।
504 Gateway Timeoutअपस्ट्रीम अनुमान समय समाप्त (जटिल तर्क मॉडल)प्रॉम्प्ट जटिलता जांचें; क्लाइंट-साइड टाइमआउट बढ़ाएं; तर्क मॉडल के लिए स्ट्रीमिंग (stream: true) सक्षम करें।