Kod ralat
Apakah maksud 401 / 403 / 404 / 429 / 5xx, lima langkah penyelesaian masalah, dan amalan yang mengelakkan ralat.
Apabila sesuatu panggilan gagal, mulakan daripada kod status HTTP dan mesej ralat dalam badan respons, kemudian padankannya dengan jadual di bawah. Kebanyakan isu dapat diselesaikan melalui tiga item pertama.
Kod status
| Status | Maksud | Punca biasa dan penyelesaian |
|---|---|---|
| 400 Bad Request | Permintaan tidak sah | JSON yang cacat atau medan wajib yang hilang (model, messages); semak badan permintaan terhadap dokumen API |
| 401 Unauthorized | Pengesahan gagal | Kunci salah / dipadam / luput; lihat senarai semak dalam Pengesahan |
| 403 Forbidden | Tiada akses | Kunci atau akaun ini mungkin tidak dibenarkan memanggil model yang diminta; pastikan model itu tersedia untuk anda di pasaran |
| 404 Not Found | Sumber tiada | Biasanya ID model yang tersalah eja; salin ID yang tepat daripada pasaran model |
| 429 Too Many Requests | Had kadar dicapai | Permintaan terlalu kerap. Undur (selang eksponen) atau kurangkan konkurensi; hubungi platform jika ia berterusan |
| 5xx | Ralat pihak pelayan | Kegagalan sementara pada platform atau model huluan. Cuba semula sekali dengan parameter yang sama; jika ia terus gagal, hubungi Sokongan dengan rekod permintaan daripada halaman log |
Langkah penyelesaian masalah
- Sahkan kunci: pastikan di halaman "Kunci API" bahawa kunci itu wujud dan belum luput; padam dan cipta semula jika tidak pasti.
- Sahkan ID model: salinnya daripada pasaran model dan jangan taip dengan tangan.
- Baca badan ralat: respons ralat biasanya membawa
error.messageyang menerangkan punca sebenar (baki tidak mencukupi, parameter hilang, ...). - Semak log: halaman log konsol memaparkan status, kependaman dan penggunaan bagi setiap permintaan — semak sama ada kegagalan itu terhad kepada satu model atau satu kunci sahaja.
- Masih tersekat: hubungi Sokongan dengan cap masa dan kod status daripada halaman log.
Amalan yang mengelakkan ralat
- Gunakan SDK rasmi (ia mengendalikan cubaan semula, tamat masa dan butiran protokol untuk anda);
- Laksanakan undur eksponen bagi 429 / 5xx daripada menghentam dengan cubaan semula berulang;
- Tetapkan had perbelanjaan pada kunci produksi supaya trafik abnormal tidak dapat menghabiskan baki.