Developer guide
შეცდომის კოდები
ქმედებები და ხელახლა ცდის წესები სტატუსის კოდების მიხედვით
ამ გვერდზე შეჯამებულია გეითვეის მიერ დაბრუნებული სტატუსის კოდები და მათი მნიშვნელობები, ასევე თითოეული კოდის შემთხვევაში საჭირო ქმედებები.
თუ upstream აბრუნებს 4xx·5xx კოდს, ეს კოდი უცვლელად გადაეცემა, ხოლო სხვა შემთხვევებში გამოიყენება ქვემოთ მოცემული ცხრილი.
ასევე აღწერილია ორი თავსებადი სპეციფიკაციის შეცდომის პასუხის ფორმატი, Anthropic-თან თავსებადი error.type-ის წესები და კონსოლის ეკრანი, სადაც ლიმიტებისა და გამოყენების შემოწმებაა შესაძლებელი.
სტატუსის კოდი
| კოდი | მნიშვნელობა | ქმედება |
|---|---|---|
| 400 | მოთხოვნის მნიშვნელობის შეცდომა. Anthropic-თან თავსებადი მოდელების სიის limit სცდება 1~1000 დიაპაზონს, ან მცდელობაა შენახული პასუხის გაგრძელებისა GET /responses/{responseId}?stream=true-ის გამოყენებით | მნიშვნელობა დიაპაზონის ფარგლებში შეასწორეთ. შენახული პასუხი stream-ის გარეშე მიიღეთ. |
| 401 | გასაღები არ არის მითითებული, ვადაგასულია ან გაუქმებულია | API გასაღებების გვერდზე შეამოწმეთ გასაღების სტატუსი და გადაამოწმეთ ჰედერის სახელი და Bearer პრეფიქსი. |
| 403 | მოდელზე წვდომის უფლების არქონა, გამოყენების ლიმიტის გადაჭარბება, არასაკმარისი კრედიტი ან ხმის მფლობელი არ ხართ | error.message მიზეზებს ერთმანეთისგან განასხვავებს. მნიშვნელობები იხილეთ ქვემოთ მოცემულ ლიმიტებისა და გამოყენების შემოწმების განყოფილების ეკრანზე. |
| 404 | მოდელი არ არსებობს ან ამ გასაღებით მასზე წვდომა შეუძლებელია (მათ შორის, მოდელები, რომელთა მხარდაჭერაც დასრულებულია), გზა არ არსებობს, ან CleviDrive-ის შედეგს შენახვის 3-დღიანი ვადა გაუვიდა | ჯერ GET /models-ის საშუალებით შეამოწმეთ გამოსაძახებელი მოდელების სია. გზა API-ის გამოძახების გვერდზე მოცემულ ცხრილს შეადარეთ. |
| 408 · 409 · 413 | upstream-ის დროის ამოწურვა, გადატვირთულობა ან მოთხოვნის ზომის გადაჭარბება. ხმოვანი·ხმის გზებისთვის დაწესებული დროის ლიმიტია 5 წუთი, ხოლო მოთხოვნის მაქსიმალური ზომა — 28 MiB | თუ 409 პასუხში Retry-After არის მითითებული, დაელოდეთ მითითებული დროის განმავლობაში. 413-ის შემთხვევაში მოთხოვნა დაყავით ნაწილებად და ისე გაგზავნეთ. |
| 429 | upstream-ის პროვაიდერმა სიჩქარის ლიმიტი დააწესა | თუ Retry-After დაბრუნდა, მიჰყევით მას უცვლელად; თუ არა, ხელახლა სცადეთ ექსპონენციური backoff-ის გამოყენებით. |
| 5xx | გეითვეის ან upstream-ის დროებითი შეცდომა (მათ შორის 503) | ხელახლა სცადეთ ექსპონენციური backoff-ის გამოყენებით. თუ პრობლემა განმეორდება, დახმარებისა და საკონტაქტო ფორმის მეშვეობით შეგვატყობინეთ და მიუთითეთ X-Request-Id. |
ხელახლა ცდა
გეითვეი საკუთარ 429-ს არ წარმოქმნის და არც upstream-ის პასუხს ცდის ხელახლა შეუმჩნევლად, არც რიგში ათავსებს.
ლოდინსა და ხელახლა ცდას კლიენტი ასრულებს.
| კოდი | ლოდინის დრო | შემდეგი ნაბიჯი |
|---|---|---|
| 409 | თუ Retry-After არსებობს, იმ დროის განმავლობაში | იგივე მოთხოვნას ხელახლა აგზავნის. |
| 429 | თუ Retry-After არსებობს, იმ დროის განმავლობაში; თუ არ არსებობს, ექსპონენციური backoff | იგივე მოთხოვნას ხელახლა აგზავნის. |
| 5xx | ექსპონენციური backoff | თუ მეორდება, მოგვმართეთ. |
| 413 | ლოდინის გარეშე | მოთხოვნას ნაწილებად აგზავნის. |
შეცდომის სხეული
შეცდომის სხეულის ფორმატი სპეციფიკაციის მიხედვით განსხვავდება. upstream-ის შეცდომიდან მხოლოდ შეტყობინებას ვტოვებთ, ვამუშავებთ და ისე გადმოგცემთ; stack და შიდა ველები არ გადმოიცემა.
ეს არის 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 გასაღები |