Kesalahan dan percobaan ulang
Arti setiap status dan tindakan yang diperlukan.
Kesalahan berupa JSON dengan bidang detail. Gunakan status dan header percobaan ulang; simpan detail untuk log dan petunjuk pengguna.
| Status | Arti | Tindakan |
|---|---|---|
400 | Input tidak valid, mesin tidak dikenal, atau perutean salah | Perbaiki permintaan atau pilih mesin yang tersedia |
401 | PIN atau kunci API tidak ada atau salah | Kirim kredensial |
403 | Pemanggil tidak dapat memakai rute lokal atau admin | Gunakan loopback atau rute yang diizinkan |
409 | Model atau status yang diperlukan tidak ada | Instal model yang disarankan atau selesaikan konflik |
422 | Isi permintaan gagal divalidasi | Perbaiki nama, tipe, atau rentang bidang |
429 | Antrean GPU penuh | Tunggu Retry-After, lalu coba lagi |
500 | Kegagalan mesin atau server yang tidak terduga | Catat detail; coba lagi hanya jika aman |
503 | Pemuatan mesin atau generasi sementara tidak tersedia | Patuhi Retry-After |
504 | Transkripsi atau generasi yang dilindungi kehabisan waktu | Coba sekali lagi; kurangi pekerjaan jika terulang |
Percobaan ulang
Coba ulang 429, 503 yang dapat dicoba ulang, dan 504 dengan backoff eksponensial terbatas. VoiceStudio dapat mengirim:
Retry-After: 30
X-OmniVoice-Retryable: trueJangan coba ulang 400, 401, 403, atau 422 secara otomatis. 409 memerlukan instalasi model atau perubahan eksplisit lain terlebih dahulu.
Untuk tugas sulih suara dan batch, lanjutkan dari status tugas setelah koneksi terputus alih-alih mengunggah media lagi.