Developer guide
பிழைக் குறியீடு
நிலை குறியீட்டின்படி கையாளுதல் மற்றும் மீண்டும் முயற்சிக்கும் விதிகள்
அப்ஸ்ட்ரீம் 4xx·5xx ஐத் திருப்பி அனுப்பினால், கேட்வே அந்தக் குறியீட்டையே அப்படியே அனுப்புகிறது. மற்ற சந்தர்ப்பங்களில், கீழே உள்ள அட்டவணையின் விதிகளைப் பின்பற்றுகிறது.
400·401·403·404·413 ஆகியவை கோரிக்கை அல்லது அமைப்பைச் சரிசெய்ய வேண்டிய குறியீடுகள்; 409·429·5xx ஆகியவை கிளையன்ட் காத்திருந்து அதே கோரிக்கையை மீண்டும் அனுப்ப வேண்டிய குறியீடுகள்.
பிழை உடலின் வடிவம் விவரக்குறிப்புக்கு ஏற்ப மாறுபடும்; Anthropic-இணக்கமான பாதையில் error.type என்பது நிலைக் குறியீட்டால் நிர்ணயிக்கப்படுகிறது.
403-க்கான காரணத்தை error.message மூலம் வேறுபடுத்திக் கண்டறியவும்; வரம்பு மற்றும் பயன்பாட்டு அளவுகளை கன்சோல் திரையில் சரிபார்க்கவும்.
நிலை குறியீடு
| குறியீடு | பொருள் | கையாளுதல் |
|---|---|---|
| 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 உட்பட). | அதிவேகப் பின்வாங்கல் முறையில் மீண்டும் முயற்சிக்கவும். தொடர்ந்து ஏற்பட்டால் தொடர்புகொள்ளவும். |
402 திருப்பி அனுப்பப்படாது. கிரெடிட் பற்றாக்குறையும் பயன்பாட்டு வரம்பு மீறலும் 403 ஆகவே திருப்பி அனுப்பப்படும்.
மீண்டும் முயற்சித்தல் மற்றும் தொடர்புகொள்ளுதல்
கேட்வே தனியாக 429-ஐ உருவாக்காது; அப்ஸ்ட்ரீம் பதில்களை மாற்றாக மீண்டும் முயற்சிக்கவோ வரிசையில் வைக்கவோாது. காத்திருத்தலும் மீண்டும் முயற்சித்தலும் கிளையண்டால் செய்யப்பட வேண்டும்.
தொடர்புகொள்ளும்போது, உதவி மற்றும் தொடர்பு பிரிவின் மூலம் X-Request-Id உடன் தெரிவிக்கவும். X-Request-Id அனுப்பப்படவில்லை என்றால், சேவையகம் வழங்கிய மதிப்பு Anthropic-இணக்கமான பதிலின் request-id தலைப்பில் இருக்கும்.
பிழை உள்ளடக்கம்
பிழை உடலின் வடிவம் விவரக்குறிப்பின்படி மாறுபடும். மேல்நிலைப் பிழைகளில் செய்தியை மட்டும் வைத்துச் சீரமைத்து அனுப்புகிறோம்; ஸ்டேக் அல்லது உள் புலங்களை அனுப்புவதில்லை.
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 விசை |