DeepSeek API का इंटीग्रेशन गाइड: OpenAI-समर्थित अनुरोधों के माध्यम से ECAIX

यह गाइड दिखाता है कि DeepSeek मॉडल आईडी को ECAIX के माध्यम से OpenAI-समर्थित API एंडपॉइंट के माध्यम से टेस्ट करने का तरीका है। इसमें सबसे छोटा काम करने वाला अनुरोध, Python और curl के उदाहरण, मॉडल आईडी की पुष्टि, स्ट्रीमिंग, संरचित आउटपुट, टूल्स, और सामान्य त्रुटियों के लिए एक निदान पथ शामिल है।

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

जल्दी शुरू

यदि आप पहले से ही एक OpenAI SDK का उपयोग करने वाला अनुप्रयोग already हैं:

1. DeepSeek v4.1 Flash मॉडल पेज को खोलें और सुनिश्चित करें कि आईडी उपलब्ध है।
2. ECAIX API कीय की बनाएं।
3. OpenAI-समर्थित बेस URL को https://ecaix.com/api/ai/v1 रखें।
4. जहाँ संभव हो, SDK और अनुप्रयोग कोड को अपडेट न करें।
5. नीचे दिए गए सबसे छोटे अनुरोध को चलाएं।
6. स्ट्रीमिंग, JSON आउटपुट या टूल्स को केवल तब जोड़ें जब आधारिक अनुरोध काम कर रहा हो।

एंडपॉइंट और मॉडल आईडी

OpenAI-समर्थित क्लाइंट्स के लिए उपयोग करें:

Base URL: https://ecaix.com/api/ai/v1
Model:    deepseek-v4.1-flash

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

एंडपॉइंट फॉर्मेट भी महत्वपूर्ण है। SDK को बेस पथ को /v1 तक समाप्त करने की आवश्यकता है; क्लाइंट /chat/completions या अन्य ऑपरेशन पथ को जोड़ता है। बेस URL को /chat/completions को जोड़ने से बचें जब SDK इसे स्वयं जोड़ रहा हो।

Python के साथ OpenAI SDK का उपयोग

वIRTUAL ENVIRONMENT में OpenAI Python SDK को स्थापित या अपडेट करें:

python -m pip install --upgrade openai

फिर ECAIX बेस URL और API की को कॉन्फ़िगर करें:

const client = new OpenAI({
  apiKey: process.env.ECAIX_API_KEY,
  baseURL: "https://ecaix.com/api/ai/v1",
});

const response = await client.chat.completions.create({
  model: "deepseek-v4.1-flash",
  messages: [
    { role: "user", content: "Return one short sentence about API testing." },
  ],
  max_tokens: 128,
});

console.log(response.choices[0].message.content);

API अनुरोध के लिए सर्वर-साइड कोड का उपयोग करें। ब्राउज़र अनुप्रयोग को ECAIX की को क्लाइंट-साइड जावास्क्रिप्ट में暴लपित न करें।

Curl निदान अनुरोध

यदि SDK विफल हो जाता है, तो SDK को समस्या से बाहर निकालें और एंडपॉइंट को सीधे टेस्ट करें। हेडर और बॉडी को अलग रखें ताकि HTTP समस्या और प्रतिक्रिया फॉर्मेट समस्या को अलग किया जा सके।

curl -sS -D /tmp/ecaix-deepseek-headers.txt \
  -o /tmp/ecaix-deepseek-response.json \
  -w '\nHTTP %{http_code}\n' \
  "https://ecaix.com/api/ai/v1/chat/completions" \
  -H "Authorization: Bearer ${ECAIX_API_KEY}" \
  -H "content-type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [
      {"role": "user", "content": "Reply with one short sentence."}
    ],
    "max_tokens": 128
  }'

पब्लिक टिकट में हेडर या प्रतिक्रिया को पেস্ট न करें बिना API कीय, अनुरोध आईडी, प्रॉम्प्ट, रिपॉजिटरी पथ और ग्राहक डेटा को हटा दें।

प्रतिक्रिया का निदान

निम्नलिखित क्रम का उपयोग करें:

1. HTTP स्टेटस: जांचें कि अनुरोध एक वैध एंडपॉइंट तक पहुंचा है।
2. प्रतिक्रिया बॉडी: प्रदाता या गेटवे की त्रुटि कोड पढ़ें।
3. मॉडल आईडी: वर्तमान मॉडल डायरेक्टरी से सटीक आईडी कॉपी करें।
4. अUTHENTICATION: की हेडर, खाता और अनुमतियों की जांच करें।
5. अनुरोध का आकार: बॉडी को model, messages और छोटे आउटपुट सीमा पर कम करें।
6. फीचर फील्ड: स्ट्रीमिंग, JSON या टूल्स एक-एक करके जोड़ें।
7. SDK व्यवहार: SDK अनुरोध को सीधे curl अनुरोध के साथ तुलना करें।

इससे एक क्लाइंट लाइब्रेरी की समस्या को मॉडल रूटिंग या खाता अनुमतियों से भ्रमित न करें।

स्ट्रीमिंग प्रतिक्रियाएँ

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

stream = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "Summarize API retries in three points."}],
    stream=True,
    max_tokens=256,
)

for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

एंडपॉइंट और SDK के अनुसार सटीक इवेंट व्यवहार अलग हो सकता है। अपने फ्रेमवर्क द्वारा खाली डेल्टा, अंतिम उपयोग इवेंट, कनेक्टिविटी बाधा और [DONE]-स्टाइल टर्मिनेशन के व्यवहार को सत्यापित करें। स्ट्रीमिंग इम्प्लिमेंटेशन को प्रोडक्शन-रेडी नहीं कहें जब तक आप डिस्कनेक्ट और रिट्रीट्स को टेस्ट नहीं कर चुके हों।

संरचित आउटपुट और JSON

यदि आप मशीन-लेखनीय आउटपुट की आवश्यकता है, तो पहले एक सामान्य अनुरोध करें और फिर एंडपॉइंट और मॉडल द्वारा समर्थित सबसे छोटे संरचित आउटपुट विकल्प को जोड़ें। प्रतिवर्ती सामग्री को एक वास्तविक JSON पARSER से सत्यापित करें। एक प्रॉम्प्ट जो कहता है “JSON वापस करें” एक सCHEMA-लगाए गए प्रतिक्रिया से बिल्कुल अलग है।

import json

response = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[
        {
            "role": "user",
            "content": "Return a JSON object with keys title and priority."
        }
    ],
    response_format={"type": "json_object"},
    max_tokens=128,
)

payload = json.loads(response.choices[0].message.content)
print(payload["title"])

response_format को स्वीकार किया जा सकता है या मॉडल और रूट पर निर्भर करता है। यदि एंडपॉइंट एक असमर्थित-परामितर त्रुटि लौटाता है, तो फ़ील्ड को हटा दें और रूट दस्तावेज़ को सत्यापित करने से पहले और एक और फॉर्मेट की कोशिश करें।

फंक्शन कॉलिंग और टूल्स

टूल कॉलिंग टेक्स्ट जनरेशन से अलग एक अलग टेस्ट की आवश्यकता होती है। एक सुरक्षित फंक्शन से शुरू करें और वापस लौटाए गए नाम और एर्गुमेंट्स को इंस्पेक्ट करें पहले किसी भी कार्य को निष्पादित करें।

tools = [
    {
        "type": "function",
        "function": {
            "name": "get_demo_status",
            "description": "Return a fixed status for a local compatibility test.",
            "parameters": {
                "type": "object",
                "properties": {},
                "additionalProperties": False,
            },
        },
    }
]

response = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "Check the demo status."}],
    tools=tools,
    tool_choice="auto",
    max_tokens=128,
)

print(response.choices[0].message.tool_calls)

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

ओपनएआई और एनthropिक-समर्थित पथ

ईसीएक्सआई एक्सपोज़ करता है विभिन्न क्लाइंट्स के लिए अलग-अलग संगतता सतहें:

चैट कम्पलीटेशंस डॉक्युमेंटेशन, रिस्पॉन्स डॉक्युमेंटेशन, और एनthropिक संदेश डॉक्युमेंटेशन पढ़ने से पहले एक पथ चुनने से पहले पढ़ें। एक ही मॉडल आईडी सभी संगतता सतहों पर समान फ़ील्ड या व्यवहार नहीं प्रदर्शित कर सकता है।

वर्तमान मॉडल विवरण

कैपेबिलिटी और उपलब्धता की जांच के लिए लाइव विवरण पेजों का उपयोग करें:

• DeepSeek v4.1 फ्लैश
• DeepSeek v4 प्रो 202606
• Qwen 3.8 फ्लैश
• GLM 5.3

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

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

सुरक्षा और उत्पादन चेकलिस्ट

प्रयोगशाला परियोजना से आगे बढ़ने से पहले सुनिश्चित करें:

• एपीआई कुंजियाँ सर्वर-साइड में संग्रहीत हैं और रोटेट की जा सकती हैं।
• प्रॉम्प्ट और रिस्पॉन्स में अनप्रमोशनित सीक्रेट या ग्राहक डेटा नहीं होनी चाहिए।
• आप समझते हैं कि गेटवे अनुरोधों को लॉग करता है और लॉगों की रetenशन की अवधि कितनी है।
• मॉडल उपलब्धता और मूल्यांकन को लाइव पेजों से जांचें।
• टाइमआउट, रिट्राई, आईडीम्पोटेंस और दर सीमाओं को आपकी एप्लिकेशन द्वारा संभाला जाना चाहिए।
• स्ट्रीमिंग डिस्कनेक्ट्स डुप्लिकेट जॉब्स नहीं बनाएं।
• टूल कॉल्स में अलाउलिस्ट, वैलिडेशन, ऑथराइजेशन और ऑडिट लॉग्स होनी चाहिए।
• प्रदाता और गेटवे शर्तें आप भेजने वाले वर्कलोड को अनुमति देनी चाहिए।

रिलीज़ से पहले इंटीग्रेशन रिकॉर्ड करें

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

अक्सर पूछे जाने वाले प्रश्न

यह DeepSeek एपीआई एंडपॉइंट आधिकारिक है?

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

मैं ओपनएआई SDK के बिना अपने अनुप्रयोग को पुनरुत्थानित कर सकता हूँ?

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

मैं किस DeepSeek मॉडल का उपयोग करना चाहिए?

मॉडल डायरेक्टरी में जाने और कार्य के लिए चुनें: कोडिंग, तर्क, कॉन्टेक्स्ट लंबाई, मल्टीमोडल इनपुट, या लागत आवश्यकताओं। केवल एक पुराने लेख से नाम को कॉपी करने से बचें। वर्तमान मॉडल आईडी और अपने प्रॉम्प्ट्स के खिलाफ टेस्ट करें।

मैं क्लोड कोड के साथ इसका उपयोग कर सकता हूँ?

एनthropिक-समर्थित पथ को एक थर्ड-पार्टी प्रदाता के रूप में परीक्षण किया जा सकता है, लेकिन एनthropिक क्लोड कोड को गेटवे के माध्यम से नॉन-क्लोड मॉडल पर रूटिंग का समर्थन नहीं करता है। इसे आधिकारिक एनthropिक समर्थन या पूर्ण क्लोड कोड संगतता के गारंटी के रूप में प्रस्तुत न करें।

मैं वर्तमान मूल्यांकन और सीमाओं की जांच कहाँ करूँ?

ईसीएक्सआई मूल्यांकन पृष्ठ, मॉडल डायरेक्टरी, और आपका खाता नियंत्रण। इस लेख से किसी भी मूल्यांकन को एप्लिकेशन में हार्डकोड न करें।