Developer guide
त्रुटि कोड
स्थिति कोडअनुसार गर्ने कार्य र पुनःप्रयासका नियमहरू
यस पृष्ठमा गेटवेले फर्काउने स्थिति कोडहरू र तिनको अर्थ, साथै प्रत्येक कोडअनुसार गर्नुपर्ने कार्यहरू व्यवस्थित गरिएको छ।
अपस्ट्रीमले 4xx·5xx फर्काएमा उक्त कोड जस्ताको तस्तै पठाइन्छ; अन्य अवस्थामा तलको तालिका लागू हुन्छ।
दुई अनुकूलता मापदण्डका त्रुटि मुख्य भागका ढाँचाहरू, Anthropic अनुकूल error.type का नियमहरू, तथा सीमा र प्रयोग जाँच गर्ने कन्सोल स्क्रिन पनि समावेश गरिएको छ।
स्थिति कोड
| कोड | अर्थ | गर्नुपर्ने कार्य |
|---|---|---|
| 400 | अनुरोध मानमा त्रुटि। Anthropic अनुकूल मोडल सूचीको limit 1~1000 को दायराभन्दा बाहिर छ, वा GET /responses/{responseId}?stream=true प्रयोग गरी सुरक्षित गरिएको प्रतिक्रिया पुनः प्राप्त गर्न खोजिएको छ | मानलाई तोकिएको दायराभित्र सच्याउनुहोस्। सुरक्षित गरिएको प्रतिक्रिया stream बिना प्राप्त गर्नुहोस्। |
| 401 | कुञ्जी छैन वा म्याद सकिएको·रद्द गरिएको कुञ्जी | API कुञ्जी स्क्रिनमा कुञ्जीको स्थिति जाँच गर्नुहोस् र हेडरको नाम तथा Bearer उपसर्ग जाँच गर्नुहोस्। |
| 403 | मोडल पहुँच अनुमति छैन, प्रयोग सीमा नाघिएको, क्रेडिट अपर्याप्त, वा भ्वाइसको मालिक होइन | error.message ले कारण छुट्याएर देखाउँछ। सङ्ख्याहरू तलको सीमा र प्रयोग जाँच गर्ने खण्डको स्क्रिनमा हेर्नुहोस्। |
| 404 | मोडल छैन वा यो कुञ्जीबाट पहुँच गर्न सकिँदैन (समर्थन समाप्त भएका मोडलहरू सहित), नभएको मार्ग, वा 3 दिनको संरक्षण अवधि पार गरेको CleviDrive आउटपुट | पहिले GET /models मार्फत कल गर्न सकिने मोडलहरूको सूची जाँच गर्नुहोस्। मार्गलाई API कल गर्ने पृष्ठको तालिकासँग मिलाउनुहोस्। |
| 408 · 409 · 413 | अपस्ट्रीम समय सीमा नाघेको, भीडभाड, वा अनुरोधको आकार सीमा नाघेको। आवाज·भ्वाइस मार्गका लागि समय सीमा 5 मिनेट र अनुरोधको अधिकतम आकार 28 MiB हो | 409 मा Retry-After भएमा उक्त समयसम्म पर्खनुहोस्। 413 मा अनुरोधलाई विभाजन गरेर पठाउनुहोस्। |
| 429 | अपस्ट्रीम प्रदायकले गति सीमा लगाएको अवस्थामा | Retry-After आएमा त्यसैअनुसार गर्नुहोस्; नआएमा घातीय ब्याकअफ प्रयोग गरी पुनःप्रयास गर्नुहोस्। |
| 5xx | गेटवे वा अपस्ट्रीमको अस्थायी त्रुटि (503 सहित) | घातीय ब्याकअफ प्रयोग गरी पुनःप्रयास गर्नुहोस्। समस्या दोहोरिएमा X-Request-Id सहित सहायता र सम्पर्कमार्फत जानकारी दिनुहोस्। |
पुनःप्रयास
गेटवेले आफ्नै 429 उत्पन्न गर्दैन, न त अपस्ट्रीम प्रतिक्रियालाई गोप्य रूपमा पुनःप्रयास गर्छ वा कतारमा राख्छ।
पर्खने र पुनःप्रयास गर्ने काम क्लाइन्टले गर्छ।
| कोड | पर्खिने समय | त्यसपछि |
|---|---|---|
| 409 | Retry-After भएमा त्यस समयसम्म | उही अनुरोध फेरि पठाउनुहोस्। |
| 429 | Retry-After भएमा त्यस समयसम्म, नभए घातीय ब्याकअफ | उही अनुरोध फेरि पठाउनुहोस्। |
| 5xx | घातीय ब्याकअफ | बारम्बार भएमा सम्पर्क गर्नुहोस्। |
| 413 | पर्खाइ छैन | अनुरोधलाई विभाजन गरेर पठाउनुहोस्। |
त्रुटिको मुख्य भाग
त्रुटिको मुख्य भागको ढाँचा स्पेसिफिकेसनअनुसार फरक हुन्छ। अपस्ट्रीम त्रुटिमा सन्देश मात्र राखेर व्यवस्थित रूपमा पठाइन्छ; स्ट्याक वा आन्तरिक फिल्डहरू समावेश हुँदैनन्।
यो OpenAI अनुकूल मार्गको मुख्य भाग हो।
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}यो Anthropic अनुकूल मार्गको मुख्य भाग हो। error.type स्थिति कोडद्वारा निर्धारण गरिन्छ।
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| स्थिति कोड | error.type |
|---|---|
| 400 | invalid_request_error |
| 401 | authentication_error |
| 403 | permission_error |
| 404 | not_found_error |
| 413 | request_too_large |
| 429 | rate_limit_error |
| 529 | overloaded_error |
| अन्य कोडहरू | api_error |
सीमा र प्रयोग जाँच गर्नुहोस्
सीमाका मानहरू प्रत्येक वर्कस्पेसअनुसार फरक हुन्छन्। 403 को कारण error.message मा जाँच गरेपछि तलको स्क्रिनमा मानहरू हेर्नुहोस्।
| जाँच गर्नुपर्ने कुरा | कन्सोल स्क्रिन |
|---|---|
| मेरो वर्कस्पेसमा लागू भएको सीमा | अवलोकनमा तोकिएको प्रयोग सीमा |
| प्लानले अनुमति दिने दायरा र बाँकी रकम | प्लान र क्रेडिट |
| वास्तविक प्रयोग (मोडेलअनुसार·किअनुसार कलहरूको संख्या, अनुमानित कटौती हुने क्रेडिट) | प्रयोग |
| किको स्थिति (म्याद सकिएको·रद्द गरिएको छ कि छैन) | API की |