Kode kesalahan
Arti 401 / 403 / 404 / 429 / 5xx, penelusuran lima langkah, dan praktik yang mencegah kesalahan.
Ketika panggilan gagal, mulailah dari kode status HTTP dan pesan kesalahan pada body respons, lalu cocokkan dengan tabel di bawah. Sebagian besar masalah terselesaikan oleh tiga butir pertama.
Kode status
| Status | Arti | Penyebab umum dan solusinya |
|---|---|---|
| 400 Bad Request | Permintaan tidak valid | JSON rusak atau kolom wajib tidak ada (model, messages); periksa body terhadap dokumentasi API |
| 401 Unauthorized | Autentikasi gagal | Kunci salah / dihapus / kedaluwarsa; lihat daftar periksa di Autentikasi |
| 403 Forbidden | Tidak punya akses | Kunci atau akun ini mungkin tidak boleh memanggil model yang diminta; pastikan model tersebut tersedia untuk Anda di pasar model |
| 404 Not Found | Sumber daya tidak ditemukan | Biasanya karena ID model salah tulis; salin ID persisnya dari pasar model |
| 429 Too Many Requests | Terkena batas laju | Permintaan terlalu sering. Mundur sejenak (interval eksponensial) atau turunkan konkurensi; hubungi platform jika terus berlanjut |
| 5xx | Kesalahan di sisi server | Kegagalan sementara platform atau model upstream. Coba sekali lagi dengan parameter identik; jika terus gagal, hubungi Dukungan dengan catatan permintaan dari halaman log |
Langkah penelusuran masalah
- Verifikasi kunci: pastikan di halaman "API Keys" bahwa kunci ada dan belum kedaluwarsa; hapus dan buat ulang jika ragu.
- Verifikasi ID model: salin dari pasar model alih-alih mengetiknya manual.
- Baca body kesalahan: respons kesalahan biasanya memuat
error.messageyang menjelaskan penyebab persisnya (saldo tidak cukup, parameter hilang, ...). - Periksa log: halaman log dasbor menampilkan status, latensi, dan konsumsi per permintaan — periksa apakah kegagalan hanya terbatas pada satu model atau satu kunci.
- Masih buntu: hubungi Dukungan dengan stempel waktu dan kode status dari halaman log.
Praktik yang mencegah kesalahan
- Gunakan SDK resmi (SDK menangani percobaan ulang, timeout, dan detail protokol untuk Anda);
- Terapkan backoff eksponensial untuk 429 / 5xx alih-alih mengulang terus-menerus;
- Tetapkan batas pengeluaran pada kunci produksi agar lalu lintas abnormal tidak menguras saldo.