कनेक्शन और उपयोग | API दस्तावेज़

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

प्लेटफ़ॉर्म से कनेक्ट नहीं हो पा रहा?

जाँचें:

API कुंजी अतिरिक्त स्पेस या नई पंक्ति के बिना सही कॉन्फ़िगर है या नहीं।
Base URL सही है और उसमें दोहराए पथ नहीं हैं।
एंडपॉइंट पथ क्लाइंट प्रोटोकॉल से मेल खाता है, जैसे OpenAI क्लाइंट के लिए OpenAI-संगत पथ।
स्थानीय नेटवर्क, कंपनी प्रॉक्सी, फ़ायरवॉल, DNS या HTTPS निरीक्षण अनुरोध रोक रहा है या नहीं।
API कुंजी समाप्त, हटाई गई या प्रतिबंधित खाते की है या नहीं।

OpenAI-संगत कॉल के लिए न्यूनतम नॉन-स्ट्रीमिंग अनुरोध से परखें:

bash

curl https://api.apihop.ai/openai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      { "role": "user", "content": "Reply with OK only." }
    ],
    "stream": false
  }'

न्यूनतम अनुरोध विफल हो तो समस्या आम तौर पर नेटवर्क, प्रमाणीकरण, पथ कॉन्फ़िगरेशन, मॉडल अनुमति या खाते की स्थिति में होती है।

मॉडल चुना है लेकिन उत्तर नहीं आता या त्रुटि आती है?

सामान्य कारण:

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

कंसोल या मॉडल सूची से सही मॉडल ID कॉपी करें, न्यूनतम बॉडी से परखें, फिर संदर्भ और पैरामीटर धीरे-धीरे वापस जोड़ें।

चैट में त्रुटि या डिस्कनेक्शन हो तो?

विफलता का स्थान पहचानें:

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

सुझाया गया प्रबंधन:

विशिष्ट त्रुटि फ़ील्ड पढ़ें।
मॉडल विफलता और स्ट्रीम पार्सिंग विफलता अलग करने के लिए अस्थायी रूप से नॉन-स्ट्रीमिंग लें।
429, अस्थिर नेटवर्क और कुछ 5xx त्रुटियों पर बैकऑफ़ पुनःप्रयास जोड़ें।
सर्वर पर बातचीत की स्थिति मान लेने के बजाय पुनःप्रयास में आवश्यक संदर्भ दें।
समस्या बनी रहे तो X-Request-ID दर्ज करें।