Developer guide

កូដកំហុស

ការដោះស្រាយ និងច្បាប់សាកល្បងម្ដងទៀតតាមកូដស្ថានភាព

ទំព័រនេះរៀបរាប់អំពីកូដស្ថានភាពដែល Gateway ត្រឡប់មកវិញ អត្ថន័យរបស់វា និងការដោះស្រាយតាមកូដនីមួយៗ។
ប្រសិនបើ upstream ផ្តល់ 4xx·5xx យើងបញ្ជូនកូដនោះត្រឡប់ទៅវិញដដែល។ ក្នុងករណីផ្សេងទៀត សូមអនុវត្តតាមតារាងខាងក្រោម។
យើងក៏បានបញ្ចូលរូបរាងតួខ្លឹមសារកំហុសនៃស្តង់ដារដែលត្រូវគ្នាទាំងពីរ ច្បាប់របស់ Anthropic-compatible error.type និងអេក្រង់កុងសូលសម្រាប់ពិនិត្យកម្រិតកំណត់ និងការប្រើប្រាស់ផងដែរ។

កូដស្ថានភាព

កូដ	អត្ថន័យ	ការដោះស្រាយ
400	កំហុសតម្លៃសំណើ។ limit នៃបញ្ជីម៉ូដែលដែលត្រូវគ្នាជាមួយ Anthropic ស្ថិតក្រៅចន្លោះ 1~1000 ឬបានព្យាយាមបន្តការឆ្លើយតបដែលបានរក្សាទុកដោយប្រើ GET /responses/{responseId}?stream=true	កែតម្លៃឱ្យស្ថិតក្នុងចន្លោះដែលបានកំណត់។ សម្រាប់ការឆ្លើយតបដែលបានរក្សាទុក សូមស្នើសុំដោយគ្មាន stream។
401	គ្មានសោ ឬសោផុតកំណត់·ត្រូវបានដកហូត	ពិនិត្យស្ថានភាពសោនៅទំព័រ API key ហើយពិនិត្យឈ្មោះ header និងបុព្វបទ Bearer។
403	គ្មានសិទ្ធិចូលប្រើម៉ូដែល, លើសកម្រិតប្រើប្រាស់, ឥណទានមិនគ្រប់គ្រាន់, ឬមិនមែនជាម្ចាស់ voice	error.message នឹងបញ្ជាក់មូលហេតុឱ្យខុសគ្នា។ សម្រាប់តួលេខ សូមមើលអេក្រង់នៅផ្នែកពិនិត្យកម្រិតកំណត់ និងការប្រើប្រាស់ខាងក្រោម។
404	មិនមានម៉ូដែល ឬមិនអាចចូលប្រើបានដោយសោនេះ (រួមទាំងម៉ូដែលដែលបានបញ្ចប់ការគាំទ្រ), ផ្លូវដែលមិនមាន, ឬលទ្ធផល CleviDrive ដែលបានផុតរយៈពេលរក្សាទុក 3 ថ្ងៃ	ពិនិត្យបញ្ជីម៉ូដែលដែលអាចហៅបានជាមុនដោយប្រើ GET /models។ សម្រាប់ផ្លូវ សូមប្រៀបធៀបជាមួយតារាងនៅទំព័រ API 호출하기។
408 · 409 · 413	អស់ពេលរង់ចាំពី upstream, ការកកស្ទះ, ឬទំហំសំណើលើសកំណត់។ តាមផ្លូវសំឡេង·voice រយៈពេលកំណត់គឺ 5 នាទី ហើយកម្រិតខ្ពស់បំផុតនៃសំណើគឺ 28 MiB	ប្រសិនបើ 409 មាន Retry-After សូមរង់ចាំតាមរយៈពេលនោះ។ សម្រាប់ 413 សូមបែងចែកសំណើជាផ្នែកៗ ហើយផ្ញើ។
429	នៅពេលអ្នកផ្តល់សេវា upstream ដាក់កម្រិតល្បឿន	ប្រសិនបើមាន Retry-After សូមអនុវត្តតាមដដែល។ ប្រសិនបើគ្មាន សូមសាកល្បងម្ដងទៀតដោយប្រើ exponential backoff។
5xx	កំហុសបណ្តោះអាសន្នរបស់ Gateway ឬ upstream (រួមទាំង 503)	សាកល្បងម្ដងទៀតដោយប្រើ exponential backoff។ ប្រសិនបើបញ្ហាកើតឡើងជាបន្តបន្ទាប់ សូមជូនដំណឹងតាមជំនួយ និងទំនាក់ទំនង ដោយភ្ជាប់ X-Request-Id។

សាកល្បងម្ដងទៀត

Gateway មិនបង្កើត 429 ដោយខ្លួនឯងទេ ហើយក៏មិនសាកល្បងម្ដងទៀតចំពោះការឆ្លើយតបពី upstream ដោយស្ងាត់ ឬដាក់វាចូលជួររង់ចាំដែរ។
ការរង់ចាំ និងការសាកល្បងម្ដងទៀត ត្រូវធ្វើដោយ client។

កូដ	ពេលវេលារង់ចាំ	បន្ទាប់មក
409	ប្រសិនបើមាន Retry-After សូមរង់ចាំតាមពេលនោះ	ផ្ញើសំណើដដែលម្តងទៀត។
429	ប្រសិនបើមាន Retry-After សូមរង់ចាំតាមពេលនោះ បើគ្មានទេ ប្រើការថយចុះអិចស្ប៉ូណង់ស្យែល	ផ្ញើសំណើដដែលម្តងទៀត។
5xx	ការថយចុះអិចស្ប៉ូណង់ស្យែល	ប្រសិនបើកើតឡើងម្តងហើយម្តងទៀត សូមទាក់ទង។
413	មិនចាំបាច់រង់ចាំ	បែងចែកសំណើជាផ្នែកៗ ហើយផ្ញើ។

ខ្លឹមសារកំហុស

ខ្លឹមសារកំហុសមានទម្រង់ខុសគ្នាតាមស្តង់ដារនីមួយៗ។ កំហុសពី upstream នឹងរក្សាទុកតែសារ បន្ទាប់មករៀបចំ និងបញ្ជូនបន្ត ដោយមិនបញ្ជូន stack ឬវាលខាងក្នុងឡើយ។

នេះជាខ្លឹមសាររបស់ផ្លូវដែលអនុលោមតាម OpenAI។

JSON

{
  "error": {
    "message": "API key is required.",
    "type": "invalid_request_error"
  }
}

នេះជាខ្លឹមសាររបស់ផ្លូវដែលអនុលោមតាម Anthropic។ error.type ត្រូវបានកំណត់ដោយកូដស្ថានភាព។

JSON

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "..."
  },
  "request_id": "rqid..."
}

Anthropic-compatible error.type

កូដស្ថានភាព	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

ពិនិត្យដែនកំណត់ និងការប្រើប្រាស់

តម្លៃដែនកំណត់ខុសគ្នាតាម workspace នីមួយៗ។ បន្ទាប់ពីពិនិត្យមូលហេតុរបស់ 403 តាមរយៈ error.message សូមមើលតម្លៃនៅលើអេក្រង់ខាងក្រោម។

អ្វីដែលត្រូវពិនិត្យ	អេក្រង់កុងសូល
ដែនកំណត់ដែលកំណត់លើ workspace របស់ខ្ញុំ	ដែនកំណត់ការប្រើប្រាស់ដែលបានបែងចែកក្នុងទិដ្ឋភាពទូទៅ
វិសាលភាព និងសមតុល្យដែលគម្រោងអនុញ្ញាត	គម្រោង និងឥណទាន
ការប្រើប្រាស់ជាក់ស្តែង (ចំនួនការហៅតាមម៉ូដែល និងតាមសោ ឥណទានដែលរំពឹងថានឹងត្រូវកាត់)	ការប្រើប្រាស់
ស្ថានភាពសោ (ថាតើផុតកំណត់ ឬត្រូវបានលុបចោល)	សោ API

កូដកំហុស

កូដស្ថានភាព

សាកល្បងម្ដងទៀត

ខ្លឹមសារកំហុស

ពិនិត្យដែនកំណត់ និងការប្រើប្រាស់

ភាសា និងតំបន់

បានណែនាំ

អាស៊ីខាងកើត

អាស៊ីអាគ្នេយ៍

អាស៊ីខាងត្បូង

អាស៊ីកណ្ដាល

មជ្ឈិមបូព៌ា និងកូកាស៊ុស

អឺរ៉ុបខាងលិច និងអឺរ៉ុបខាងត្បូង

ចក្រភពអង់គ្លេស និងអៀរឡង់

អឺរ៉ុបខាងជើង

អឺរ៉ុបកណ្ដាល និងបាល់កង់

អឺរ៉ុបខាងកើត

អាហ្វ្រិកខាងកើត

អាហ្វ្រិកខាងលិច និងអាហ្វ្រិកកណ្តាល

អាហ្វ្រិកភាគខាងត្បូង

អាមេរិក

អូសេអានី