Asosiy mazmunga oʻtish

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.

JSON
{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_request",
    "message": "The text field is required.",
    "param": "text",
    "fields": {
      "text": "The text field is required."
    }
  },
  "request_id": "0b8e8a5e-6f5c-4f7e-9d63-2c1f0f4b7a51"
}

MaydonMaʼnosi
error.typeXato turkumi, uni HTTP holati belgilaydi. Turlar quyida keltirilgan.
error.codeDasturlar uchun oʻzgarmas kod. Nima qilishni shu maydonga qarab hal qiling.
error.messageNima notoʻgʻri ketgani, odamlar uchun yozilgan. U oʻzgarishi mumkin, shuning uchun unga hech qachon tayanmang.
error.paramBirinchi notoʻgʻri parametr yoki null.
error.fieldsFaqat tekshiruv xatolarida: har bir notoʻgʻri maydon va uning birinchi xabari.
request_idUshbu 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.

HolatTur
402insufficient_quota
429rate_limit_error
5xxserver_error
Boshqa har qanday 4xxinvalid_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.

JavobNima 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 manziliKalit 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.

KodMaʼnosi
invalid_request

400, 422invalid_request_error

Soʻrov notoʻgʻri tuzilgan yoki tekshiruvdan oʻtmagan.
invalid_api_key

401invalid_request_error

API kalit yoʻq yoki tanilmadi.
api_key_disabled

401invalid_request_error

API kalit oʻchirib qoʻyilgan, uni qayta yoqish mumkin.
api_key_revoked

401invalid_request_error

API kalit chaqirib olingan va uni boshqa hech qachon ishlatib boʻlmaydi.
api_key_expired

401invalid_request_error

API kalitning amal qilish muddati oʻtgan.
insufficient_balance

402insufficient_quota

Tashkilot balansi bu soʻrov uchun yetarli emas.
spend_limit_exceeded

402insufficient_quota

Soʻrov API kalitning oylik sarf limitidan oshib ketishiga olib keladi.
insufficient_permissions

403invalid_request_error

API kalitda bu soʻrov uchun kerakli ruxsat yoʻq.
ip_not_allowed

403invalid_request_error

Soʻrovning IP manzili API kalitning ruxsat etilgan manzillari roʻyxatida yoʻq.
no_organization

403invalid_request_error

API kalit tashkilotsiz foydalanuvchiga tegishli.
voice_unavailable

403invalid_request_error

Bu voice_id ushbu hisob uchun mavjud emas.
forbidden

403invalid_request_error

Bu API kalitga ushbu soʻrovni bajarishga ruxsat berilmagan.
not_found

404invalid_request_error

Yoʻnalish yoki resurs bu tashkilotda mavjud emas.
model_not_found

404invalid_request_error

Soʻralgan model mavjud emas yoki undan foydalanib boʻlmaydi.
method_not_allowed

405invalid_request_error

Bu HTTP metodi ushbu yoʻnalishda qoʻllab-quvvatlanmaydi.
conflict

409invalid_request_error

Soʻrov resursning joriy holatiga zid.
idempotency_conflict

409invalid_request_error

Bu Idempotency-Key boshqa soʻrov bilan ishlatilgan.
job_not_finished

409invalid_request_error

TTS vazifasi hali tugamagan.
job_failed

409invalid_request_error

TTS vazifasi muvaffaqiyatsiz tugagan, audio yoʻq.
gone

410invalid_request_error

Resurs endi mavjud emas.
audio_expired

410invalid_request_error

TTS vazifasi audiosining saqlanish muddati oʻtgan.
audio_too_large

413invalid_request_error

Audio MCP resursi sifatida yuborish uchun juda katta; uni havola orqali yuklab oling.
input_too_large

413, 422invalid_request_error

Kirish maʼlumoti hajm chegarasidan oshgan.
unsupported_media_type

415invalid_request_error

Yuklangan fayl turi qoʻllab-quvvatlanmaydi.
batch_too_large

422invalid_request_error

Paketda embedding uchun kirishlar juda koʻp.
too_many_documents

422invalid_request_error

Soʻrovda qayta saralash uchun hujjatlar juda koʻp.
context_length_exceeded

422invalid_request_error

Prompt va max_tokens birgalikda model kontekst uzunligidan oshadi.
upstream_rejected_input

422invalid_request_error

Model serveri kirish maʼlumotini rad etdi; uni oʻzgarishsiz qayta yuborish natija bermaydi.
rate_limit_exceeded

429rate_limit_error

API kalit yoki uning tashkiloti uchun daqiqalik soʻrovlar limiti oshib ketdi.
concurrency_limit_exceeded

429rate_limit_error

Bu API kalit yoki uning tashkiloti uchun bir vaqtda bajarilayotgan soʻrovlar juda koʻp.
upstream_rate_limited

429rate_limit_error

Model serveri toʻla band; birozdan keyin qayta urining.
too_many_active_jobs

429rate_limit_error

Bu API kalit yoki uning tashkilotida navbatdagi yoki bajarilayotgan TTS vazifalari juda koʻp.
server_error

500server_error

Kutilmagan xatolik yuz berdi.
synthesis_failed

500server_error

Nutq yoki dialog yaratilmadi; birozdan keyin qayta urining.
transcription_failed

500server_error

Transkripsiya bajarilmadi; birozdan keyin qayta urining.
upstream_error

502server_error

Model yoki ovoz xizmatida nosozlik yuz berdi; birozdan keyin qayta urining.
service_unavailable

503server_error

Kerakli xizmat vaqtincha ishlamayapti.
storage_failed

503server_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.