क्लाउड कोड का कस्टम API एंडपॉइंट: तृतीय-पक्ष गेटवे सेटअप और चाइनीज ओपन-सोर्स मॉडल्स के साथ

क्लाउड कोड को Anthropic-समर्थित एंडपॉइंट से संवाद करने के लिए कॉन्फ़िगर किया जा सकता है, जिससे आप एक प्रोवाइडर के एंडपॉइंट का उपयोग करने के बजाय एक गेटवे-मनेज्ड वर्कफ़्लो का परीक्षण कर सकते हैं। यह गेटवे द्वारा暴ल्पित मॉडल आईडी के साथ चाइनीज ओपन-सोर्स मॉडल्स के लिए ECAIX की वर्तमान मॉडल कैटलॉग में उपलब्ध होने के लिए भी संभव बनाता है।

यह गाइड एक प्रोवाइडर-स्पेसिफिक, तृतीय-पक्ष संगतता कार्यप्रणाली के बारे में है। Anthropic के आधिकारिक क्लाउड कोड गेटवे दस्तावेज़ बताते हैं कि Anthropic क्लाउड कोड को गेटवे के माध्यम से नॉन-क्लाउड मॉडल्स को रूटिंग नहीं करता है। ECAIX यह दावा नहीं करता है कि यह कार्यप्रणाली Anthropic द्वारा आधिकारिक रूप से समर्थित है, और एक नॉन-क्लाउड मॉडल सभी क्लाउड कोड क्षमताओं को प्रदान नहीं कर सकता।

जल्दी शुरू करें

यदि आप संगतता सीमा को समझते हैं, तो पहले इस सरल मार्ग का उपयोग करें:

1. वर्तमान ECAIX मॉडल कैटलॉग में एक सक्रिय मॉडल आईडी चुनें।
2. एक ECAIX एपीआई की बनाएं और इसे स्रोत नियंत्रण से बाहर रखें।
3. ANTHROPIC_BASE_URL को https://ecaix.com/api/ai/v1/anthropic सेट करें।
4. नीचे दिए गए डायग्नोस्टिक अनुरोध को भेजें और HTTP स्टेटस को रिकॉर्ड करें।
5. एक पढ़ने के लिए ही परीक्षण प्रोजेक्ट में claude -p चलाएं।
6. उपकरणों, स्ट्रीमिंग, कॉन्टेक्स्ट सीमाओं और अनुमतियों को अलग-अलग परीक्षण करें।

प्रकाशन समय की जांच

यह तालिका इंटेंशनल है: एक कॉन्फ़िगरेशन उदाहरण एक मापित संगतता परिणाम नहीं है।

इस सेटअप में क्या बदलाव होता है

सेटअप में चार अलग-अलग भाग होते हैं:

1. क्लाउड कोड कोड टास्क बनाता है और अनुरोध भेजता है।
2. Anthropic-समर्थित गेटवे Anthropic-स्टाइल एंडपॉइंट पर अनुरोध प्राप्त करता है।
3. मॉडल आईडी गेटवे द्वारा暴ल्पित अपस्ट्रीम मॉडल को चुनता है।
4. एपीआई की अनुरोध को प्रमाणित करता है और खाता, क्वोटा और अनुमतियों को निर्धारित करता है।

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

शुरू करने से पहले

आपकी आवश्यकताएँ हैं:

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

कैटलॉग समय के साथ बदलती रहती है। कॉन्फ़िगरेशन फ़ाइल में मॉडल आईडी कॉपी करने से पहले, ECAIX मॉडल डायरेक्टरी में खुलकर जांचें कि मॉडल सक्रिय और आपकी योजना के अनुसार API स्टाइल के लिए उपलब्ध है।

गेटवे एंडपॉइंट कॉन्फ़िगर करें

क्लाउड कोड कई स्थापनों पर ~/.claude/settings.json में सेटिंग्स स्टोर करता है। सटीक सेटिंग्स स्कीमा बदल सकती है, इसलिए नीचे दिए गए पैटर्न को शुरुआत के रूप में देखें और अपने स्थापित संस्करण के दस्तावेज़ के साथ तुलना करें।

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ecaix.com/api/ai/v1/anthropic",
    "ANTHROPIC_API_KEY": "YOUR_ECAIX_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT": "1"
  },
  "model": "deepseek-v4.1-flash"
}

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

शेल सत्र में परीक्षण करते समय भी एंडपॉइंट कॉन्फ़िगरेशन कर सकते हैं:

export ANTHROPIC_BASE_URL="https://ecaix.com/api/ai/v1/anthropic"
export ANTHROPIC_API_KEY="YOUR_ECAIX_API_KEY"
export ANTHROPIC_MODEL="deepseek-v4.1-flash"

एक विशेष क्लाउड कोड रिलीज़ द्वारा समर्थित चर और सेटिंग्स नाम बदल सकते हैं। यदि क्लाइंट ANTHROPIC_MODEL को अनदेखा करती है, तो अपने संस्करण के दस्तावेज़ में दocumented मॉडल फ़ील्ड या एलियास मेथड का उपयोग करें। गेटवे अभी भी अंतिम मॉडल आईडी को पहचानना चाहिए।

Anthropic-समर्थित एंडपॉइंट को सत्यापित करें

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

नीचे दिए गए कमांड रिस्पॉन्स हेडर और बॉडी को अलग-अलग सहेजता है, फिर HTTP स्टेटस को प्रिंट करता है। एक वास्तविक प्राधिकृत की को केवल अपने स्थानीय शेल में ही उपयोग करें; कभी भी लेख, इशू या साझा लॉग में पেস্ট न करें।

curl -sS -D /tmp/ecaix-anthropic-headers.txt \
  -o /tmp/ecaix-anthropic-response.json \
  -w '\nHTTP %{http_code}\n' \
  "${ANTHROPIC_BASE_URL}/messages" \
  -H "x-api-key: ${ANTHROPIC_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "max_tokens": 128,
    "messages": [
      {"role": "user", "content": "Reply with one short sentence."}
    ]
  }'

सामान्य व्याख्या:

• 200: रिस्पॉन्स के आकार को जांचें और वापस मिलने वाले मॉडल या उपयोग के क्षेत्रों को सत्यापित करें।
• 401 या 403: की, हेडर, खाता और अनुमति के क्षेत्र को जांचें और प्रॉम्प्ट को बदलने से पहले।
• 404: बेस यूआरएल, /messages सफेक्स और एंडपॉइंट डिप्लॉयमेंट को जांचें।
• 400: अनुरोध को सबसे छोटे वैलिड बॉडी में कम करें और मॉडल-स्पेसिफिक क्षेत्रों को जांचें।
• 5xx या टाइमआउट: अनुरोध समय और रिस्पॉन्स बॉडी को रिकॉर्ड करें, फिर गेटवे, अपस्ट्रीम और क्लाइंट टाइमआउट व्यवहार को अलग करें।

एक सफल रिस्पॉन्स यह साबित करता है कि की, एंडपॉइंट, अनुरोध फॉर्मेट और मॉडल आईडी एक साथ इस अनुरोध के लिए काम कर रहे हैं। यह यह साबित नहीं करता कि हर क्लाउड कोड फीचर काम करेगा।

टेस्ट करें क्लोड क्लोड कोड के बाद एपीआई रिक्वेस्ट काम करता है

एक बार जब सीधे रिक्वेस्ट सफल हो जाता है, तो निम्नलिखित कमांड से शुरू करें:

claude -p "Explain what this repository does without editing files."

फिर एक सीमित कार्य का परीक्षण करें। उदाहरण के लिए:

claude -p "List the likely entry points for the web application. Do not modify files."

प्रगतिशील रूप से अधिक मांग करने वाले परीक्षण करें:

1. पाठ्य उत्तर।
2. छोटा कोड व्याख्या।
3. रिपॉजिटरी नेविगेशन।
4. एक नियंत्रित संपादन एक डिस्पोजेबल ब्रांच में।
5. टूल का उपयोग या बहु-चरण कार्य।
6. स्ट्रीमिंग और लंबी Kontext व्यवहार।

एक सफल पाठ्य उत्तर से यह अनुमान नहीं लगाएं कि अनुमति प्रॉम्प्ट, टूल कॉल, स्ट्रीमिंग, Kontext सीमाएं, या फाइल संपादन क्लोड-बैक्ड सेशन के समान व्यवहार करते हैं।

सही एपीआई पथ का चयन करें

क्लोड क्लोड केवल एक क्लाइंट वर्कफ्लो है। आपकी आवश्यकता के अनुसार सही एपीआई पथ निर्धारित करें:

ईसीएक्सआई के लिए, एंथ्रोपिक संदेशों के दस्तावेज़ (एंथ्रोपिक संदेशों के एपीआई) के लिए एंथ्रोपिक-शैली के पथ का उपयोग करें और ओपनएआई-समर्थित क्लाइंट्स के लिए चैट कम्प्लीटन्स दस्तावेज़ का उपयोग करें। मॉडल डायरेक्टरी में मॉडल की वर्तमान आईडी और प्राइसिंग पेज में वर्तमान प्रदर्शित प्राइसिंग की पुष्टि करें।

समर्थन मatrix

निम्नलिखित मatrix एक प्रकाशन समय की साक्ष्य सीमा है, नहीं कि हर फीचर का समर्थन है:

इस अंतर को समझने से एक सफल न्यूनतम अनुरोध को क्लोड क्लोड के पूर्ण समर्थन प्रमाणन के रूप में प्रस्तुत करने से रोकता है।

मॉडल विवरण पेज और वर्तमान आईडी

मॉडल विवरण पेजों का उपयोग करके पुराने ब्लॉग पोस्ट से मॉडल नाम को कॉपी न करें:

• DeepSeek v4.1 फ्लैश
• Qwen 3.8 फ्लैश
• GLM 5.3
• किमी K3

ये लिंक वर्तमान मॉडल आईडी, Kontext जानकारी और पेज स्तर के विवरणों की जांच के लिए प्रवेश द्वार हैं। प्रकाशन के बाद उपलब्धता बदल सकती है।

एक त्रुटि के बाद, निम्नलिखित क्रम का उपयोग न करें:

1. HTTP स्टेटस और रिस्पॉन्स बॉडी को बचाएं।
2. आधार URL और एंडपॉइंट सफेक्स को पुष्टि करें।
3. एपीआई की कुंजी स्थानीय रूप से मौजूद है और उचित स्कोप है।
4. वर्तमान मॉडल आईडी मॉडल कैटलॉग में पुष्टि करें।
5. सबसे छोटा वैध अनुरोध पुनः प्रयास करें।
6. परिणाम को क्लोड क्लोड द्वारा भेजे गए क्लाइंट अनुरोध के साथ तुलना करें।
7. केवल इसके बाद अपरिवर्तित रूटिंग, टाइमआउट या टूल स्कीमा के अंतर का पता लगाएं।

मॉडल नहीं मिला के लिए, यह एक गलत लिखावट से अलग करता है: अनुमति समस्या, गेटवे मैपिंग समस्या, और अपरिवर्तित प्रदाता विफलता। 401 और 403 के लिए, मॉडल बदलना आमतौर पर पहला समाधान नहीं होता है। एक टेक्स्ट-सफल/टूल-फेल के मामले में, अगला परीक्षण टूल स्कीमा होना चाहिए, नहीं कि एक और पाठ्य प्रॉम्प्ट।

सामान्य त्रुटियाँ

सुरक्षा और डेटा प्रबंधन

गेटवे को एक अलग सेवा सीमा के रूप में देखें। स्रोत कोड या ग्राहक डेटा भेजने से पहले, निम्नलिखित की जांच करें:

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

किसी भी सार्वजनिक इश्यू, लेख, स्क्रीनशॉट या साझा किए गए शेल इतिहास में एक उत्पादन एपीआई की कुंजी को पेस्ट न करें।

यह आधिकारिक क्लोड क्लोड समर्थन से कैसे भिन्न है

आधिकारिक एंथ्रोपिक दस्तावेज़ क्लोड क्लोड समर्थन का प्राधिकरण है। तीसरे पक्ष का गेटवे एक समर्थित अनुरोध प्रारूप को暴露 कर सकता है, लेकिन समर्थन समाधान समान नहीं है। सुरक्षित तरीका इस वर्कफ्लो का वर्णन करना है:

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

FAQ

क्लोड सब्सक्रिप्शन के लिए इस वर्कफ्लो के लिए मुझे क्लोड सब्सक्रिप्शन की आवश्यकता है?

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

मैं कैटलॉग से किसी भी मॉडल आईडी का उपयोग कर सकता हूँ?

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

एक एंथ्रोपिक-समर्थित एंडपॉइंट टूल कॉलिंग को गारंटी देता है?

नहीं। प्रोटोकॉल समर्थन और टूल व्यवहार अलग-अलग हैं। एक छोटे फंक्शन कॉलिंग परीक्षण चलाएं और मॉडल के वर्तमान दस्तावेज़ को पढ़ने से पहले टूल का उपयोग एक स्वचालित वर्कफ्लो में।

मैं वर्तमान मॉडल और प्राइसिंग के लिए कहाँ जांचना चाहिए?

[ईसीएक्सआई म

एक व्यावहारिक संगतता चेकलिस्ट

प्रयोग के लिए टीम के लिए उपयोगी होने से पहले, प्रत्येक परीक्षण का परिणाम दर्ज करें:

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

जब इस कॉन्फ़िगरेशन का उपयोग न करें

संवेदनशील उत्पादन रिपॉजिटरी के लिए इस सेटअप का उपयोग न करें जब तक कि आप लॉगिंग, रिटेंशन, रूटिंग और एक्सेस कंट्रोल्स को समझ ना लें। एक प्रोवाइडर-संगत एंडपॉइंट को मूल प्रोवाइडर के समान सुरक्षा व्यवहार, सिस्टम प्रॉम्प्ट, टूल अनुमतियाँ और संदेश लेखन का नहीं मानना चाहिए। विनियमित या गोपनीय कार्यान्वयन के लिए, एक आंतरिक सुरक्षा समीक्षा पूरी करें और अपने संगठन द्वारा अनुमोदित एक डिप्लॉयमेंट पथ का उपयोग करें।

कॉन्फ़िगरेशन को अपडेट रखना

अगर निम्नलिखित में से कोई भी बदलाव होता है, तो समीक्षा करें:

• Claude Code अपडेट होता है।
• गेटवे अपने Anthropic-संगत कार्यान्वयन में बदलाव करता है।
• मॉडल आईडी पुनः नामित, हटा दिया जाता है या किसी अन्य अप-स्ट्रीम मॉडल से मापा जाता है।
• स्ट्रीमिंग, टूल सीमाएँ, संदेश सीमाएँ, या त्रुटि व्यवहार बदल जाते हैं।
• ECAIX लाइव कैटलॉग में दिखाए गए मॉडल या एपीआई सीमाओं में बदलाव होता है।

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

स्रोत

• Anthropic Claude Code: अन्य LLM गेटवे
• DeepSeek API दस्तावेज़
• Qwen Quickstart
• Zhipu OpenAI API संगतता