Xatolar va qayta urinishlar
Har bir xato bitta shaklga va oʻzgarmas kodga ega. Nima qilishni kodga qarab hal qiling va faqat muvaffaqiyatli boʻlishi mumkin boʻlgan soʻrovni qayta yuboring.
Xato tanasi
/v1 endpointlaridagi har bir xato, OpenAI bilan moslari ham, shu tana bilan javob beradi. Bu soʻrov identifikatori qoʻshilgan OpenAI xato obyekti, shuning uchun OpenAI SDKʼlari uni odatdagidek oʻqiydi.
| Maydon | Maʼnosi |
|---|---|
error.type | Xato turkumi, uni HTTP holati belgilaydi. Turlar quyida keltirilgan. |
error.code | Dasturlar uchun oʻzgarmas kod. Nima qilishni shu maydonga qarab hal qiling. |
error.message | Nima notoʻgʻri ketgani, odamlar uchun yozilgan. U oʻzgarishi mumkin, shuning uchun unga hech qachon tayanmang. |
error.param | Birinchi notoʻgʻri parametr yoki null. |
error.fields | Faqat tekshiruv xatolarida: har bir notoʻgʻri maydon va uning birinchi xabari. |
request_id | Ushbu soʻrov identifikatori, X-Request-Id sarlavhasidagi bilan bir xil. |
Chat oqimi boshlangandan keyin uzilsa, u shu tana bilan oxirgi hodisani, soʻng [DONE] ni yuboradi. Bu paytda holat allaqachon 200 boʻladi, shuning uchun hodisani oʻqing.
Xato turlari
Tur holatga bogʻliq. Bular OpenAI ishlatadigan toʻrtta tur.
| Holat | Tur |
|---|---|
402 | insufficient_quota |
429 | rate_limit_error |
5xx | server_error |
| Boshqa har qanday 4xx | invalid_request_error |
Soʻrov identifikatorlari
Har bir javobda, audio va xatolarda ham, X-Request-Id sarlavhasi boʻladi. Har bir xato tanasi va data maydoni bor har bir tana uni request_id sifatida takrorlaydi; OpenAI va Cohere bilan mos endpointlarning muvaffaqiyatli javoblari oʻz shaklini saqlaydi, shuning uchun u yerda sarlavhani oʻqing. Qoʻllab-quvvatlash xizmatiga yozganda uni koʻrsating: u orqali biz soʻrovni jurnallarimizdan topamiz.
Biz har bir soʻrov uchun yangi identifikator yaratamiz va siz yuborgan X-Request-Id ni hisobga olmaymiz. Takrorlangan javob ham yangi identifikator oladi.
Qachon qayta urinish kerak
Holat va kodga qarab hal qiling. Muvaffaqiyatli boʻla olmaydigan qayta urinish faqat soʻrovlar limitini sarflaydi.
| Javob | Nima qilish kerak |
|---|---|
429 | Retry-After da koʻrsatilgan soniya kuting, soʻng xuddi shu soʻrovni qayta yuboring. |
500502503 | Oraliqni oshirib qayta urining: 1 soniya, keyin 2, keyin 4, bir necha urinishdan soʻng toʻxtang. POST Idempotency-Key qabul qilsa (quyida koʻring), uni xuddi shu kalit bilan takrorlang, shunda pul ikki marta yechilmaydi. |
409 job_not_finished | Vazifa hali navbatda yoki bajarilmoqda. Bir necha soniyadan keyin uni yana tekshiring. |
409 idempotency_conflict | Bu kalit boshqa tana bilan ishlatilgan. Yangi soʻrovni yangi Idempotency-Key bilan yuboring. |
409 job_failed410 audio_expired | Audio endi boʻlmaydi. Yangi vazifa yarating. |
413 input_too_large422 input_too_large | Kirish maʼlumotini qisqartiring yoki qismlarga boʻling, soʻng qayta yuboring. |
400401402403404405409 conflict422 | Bularni hech qachon oʻzgarishsiz qayta yubormang. Avval soʻrovni, kalitni, uning ruxsatlari yoki limitlarini, yoxud balansni tuzating. |
POST soʻrovni xavfsiz takrorlash
Quyidagi POST soʻrovlarda 191 belgigacha boʻlgan Idempotency-Key sarlavhasini yuboring. Xuddi shu kalit bilan takrorlangan soʻrov asl natijani Idempotency-Replayed: 1 bilan oladi, hech narsa qayta bajarilmaydi va qayta toʻlanmaydi: oʻsha audio yoki transkripsiya, vazifaning hozirgi holati yoki ovozning hozirgi koʻrinishi. Shu kalit bilan yaratilgan ovoz oʻshandan beri oʻchirilgan boʻlsa, takrorlash yangi ovoz yaratadi. Kalitlar tashkilotingizga tegishli.
| Endpoint manzili | Kalit qancha saqlanadi |
|---|---|
POST /api/v1/tts/synthesizePOST /api/v1/tts/dialogue | 7 kun |
POST /api/v1/tts/jobs | Vazifa oʻchirilguncha, sukut boʻyicha u tugaganidan bir kun oʻtib |
POST /api/v1/stt/transcribePOST /api/v1/tts/voices | Doimo. Kalitni faqat xuddi shu soʻrov uchun qayta ishlating. |
Xuddi shu kalit boshqa tana bilan 409 idempotency_conflict, 191 belgidan uzun kalit esa 400 invalid_request javobini oladi.
Xato kodlari
API soʻrovlaringizga javob berishi mumkin boʻlgan barcha kodlar va ular bilan keladigan holatlar. Yangi kodlar paydo boʻlishi mumkin, shuning uchun notanish kodni uning holatiga qarab koʻrib chiqing.
| Kod | Maʼnosi |
|---|---|
invalid_request400, 422invalid_request_error | Soʻrov notoʻgʻri tuzilgan yoki tekshiruvdan oʻtmagan. |
invalid_api_key401invalid_request_error | API kalit yoʻq yoki tanilmadi. |
api_key_disabled401invalid_request_error | API kalit oʻchirib qoʻyilgan, uni qayta yoqish mumkin. |
api_key_revoked401invalid_request_error | API kalit chaqirib olingan va uni boshqa hech qachon ishlatib boʻlmaydi. |
api_key_expired401invalid_request_error | API kalitning amal qilish muddati oʻtgan. |
insufficient_balance402insufficient_quota | Tashkilot balansi bu soʻrov uchun yetarli emas. |
spend_limit_exceeded402insufficient_quota | Soʻrov API kalitning oylik sarf limitidan oshib ketishiga olib keladi. |
insufficient_permissions403invalid_request_error | API kalitda bu soʻrov uchun kerakli ruxsat yoʻq. |
ip_not_allowed403invalid_request_error | Soʻrovning IP manzili API kalitning ruxsat etilgan manzillari roʻyxatida yoʻq. |
no_organization403invalid_request_error | API kalit tashkilotsiz foydalanuvchiga tegishli. |
voice_unavailable403invalid_request_error | Bu voice_id ushbu hisob uchun mavjud emas. |
forbidden403invalid_request_error | Bu API kalitga ushbu soʻrovni bajarishga ruxsat berilmagan. |
not_found404invalid_request_error | Yoʻnalish yoki resurs bu tashkilotda mavjud emas. |
model_not_found404invalid_request_error | Soʻralgan model mavjud emas yoki undan foydalanib boʻlmaydi. |
method_not_allowed405invalid_request_error | Bu HTTP metodi ushbu yoʻnalishda qoʻllab-quvvatlanmaydi. |
conflict409invalid_request_error | Soʻrov resursning joriy holatiga zid. |
idempotency_conflict409invalid_request_error | Bu Idempotency-Key boshqa soʻrov bilan ishlatilgan. |
job_not_finished409invalid_request_error | TTS vazifasi hali tugamagan. |
job_failed409invalid_request_error | TTS vazifasi muvaffaqiyatsiz tugagan, audio yoʻq. |
gone410invalid_request_error | Resurs endi mavjud emas. |
audio_expired410invalid_request_error | TTS vazifasi audiosining saqlanish muddati oʻtgan. |
audio_too_large413invalid_request_error | Audio MCP resursi sifatida yuborish uchun juda katta; uni havola orqali yuklab oling. |
input_too_large413, 422invalid_request_error | Kirish maʼlumoti hajm chegarasidan oshgan. |
unsupported_media_type415invalid_request_error | Yuklangan fayl turi qoʻllab-quvvatlanmaydi. |
batch_too_large422invalid_request_error | Paketda embedding uchun kirishlar juda koʻp. |
too_many_documents422invalid_request_error | Soʻrovda qayta saralash uchun hujjatlar juda koʻp. |
context_length_exceeded422invalid_request_error | Prompt va max_tokens birgalikda model kontekst uzunligidan oshadi. |
upstream_rejected_input422invalid_request_error | Model serveri kirish maʼlumotini rad etdi; uni oʻzgarishsiz qayta yuborish natija bermaydi. |
rate_limit_exceeded429rate_limit_error | API kalit yoki uning tashkiloti uchun daqiqalik soʻrovlar limiti oshib ketdi. |
concurrency_limit_exceeded429rate_limit_error | Bu API kalit yoki uning tashkiloti uchun bir vaqtda bajarilayotgan soʻrovlar juda koʻp. |
upstream_rate_limited429rate_limit_error | Model serveri toʻla band; birozdan keyin qayta urining. |
too_many_active_jobs429rate_limit_error | Bu API kalit yoki uning tashkilotida navbatdagi yoki bajarilayotgan TTS vazifalari juda koʻp. |
server_error500server_error | Kutilmagan xatolik yuz berdi. |
synthesis_failed500server_error | Nutq yoki dialog yaratilmadi; birozdan keyin qayta urining. |
transcription_failed500server_error | Transkripsiya bajarilmadi; birozdan keyin qayta urining. |
upstream_error502server_error | Model yoki ovoz xizmatida nosozlik yuz berdi; birozdan keyin qayta urining. |
service_unavailable503server_error | Kerakli xizmat vaqtincha ishlamayapti. |
storage_failed503server_error | Audio yaratildi, lekin uni idempotent qayta urinish uchun saqlab boʻlmadi. |
Muvaffaqiyatsiz tugagan vazifa xato javobi emas. U failed holatiga oʻtadi va oʻz error.code iga ega boʻladi, ular matnni ovozga aylantirish maʼlumotnomasida vazifa bilan birga keltirilgan.