Topik ini menjelaskan parameter respons umum dan kode kesalahan umum untuk panggilan API AI Guardrails.
Parameter respons umum
Semua permintaan mengembalikan data dalam format JSON. Tabel berikut menjelaskan bidang umum dalam parameter respons.
|
Name |
Type |
Description |
|
Code |
Integer |
Kode kesalahan.
Untuk informasi lebih lanjut, lihat Kode kesalahan umum. |
|
Msg |
String |
Deskripsi detail mengenai kesalahan. |
|
RequestId |
String |
ID unik dari permintaan. Gunakan ID ini untuk melacak masalah. |
|
Data |
|
Data respons (bisnis) yang terkait dengan API. Bidang ini mungkin kosong jika terjadi kesalahan. Biasanya berupa struktur JSON atau array. |
Kode kesalahan umum
|
Code |
Msg |
Description |
|
200 |
OK |
Permintaan berhasil. |
|
280 |
PROCESSING |
Tugas sedang diproses. Tunggu beberapa saat, misalnya 5 detik, lalu kueri hasilnya. |
|
400 |
BAD_REQUEST |
Permintaan tidak valid. Biasanya karena parameter permintaan salah. Periksa kembali parameter permintaan Anda. |
|
401 |
NOT_ALLOWED |
Permintaan gagal. Biasanya karena URL tidak aman digunakan untuk file gambar atau video. |
|
403 |
FORBIDDEN |
Permintaan akses gagal. Biasanya karena URL file gambar atau video Anda tidak dapat diakses. Pastikan kontennya dapat diakses melalui Internet dan kebijakan Perlindungan hotlink tidak diaktifkan. |
|
404 |
NOT_FOUND |
Konten yang akan dimoderasi tidak ditemukan. Biasanya karena konten gambar atau video tidak dapat diunduh. Pastikan kontennya dapat diakses melalui Internet. |
|
480 |
DOWNLOAD_FAILED |
Pengunduhan gagal. Pastikan ukuran konten dan resolusi (jika ada) berada dalam batas API. |
|
500 |
GENERAL_ERROR |
Terjadi kesalahan sementara di sisi server. Coba ulang permintaan. Jika kode kesalahan ini terus muncul, hubungi kami melalui Online Service. |
|
503 |
ServiceUnavailable |
Terjadi kesalahan sistem. Periksa apakah Nama domain yang diminta valid. Jika Nama domain valid, hubungi kami melalui Online Service dan berikan detail kasus tersebut. |
|
580 |
DB_FAILED |
Operasi database gagal. Coba ulang permintaan. Jika kode kesalahan ini terus muncul, hubungi kami melalui Online Service. |
|
581 |
TIMEOUT |
Terjadi timeout. Coba ulang permintaan. Jika kode kesalahan ini terus muncul, hubungi kami melalui Online Service. |
|
585 |
CACHE_FAILED |
Terjadi kesalahan cache. Coba ulang permintaan. Jika kode kesalahan ini terus muncul, hubungi kami melalui Online Service. |
|
586 |
ALGO_FAILED |
Terjadi kesalahan algoritma. Hubungi kami melalui Online Service. |
|
587 |
MQ_FAILED |
Terjadi kesalahan middleware. Hubungi kami melalui Online Service. |
|
588 |
EXCEED_QUOTA |
Frekuensi permintaan melebihi kuota. Kuota default: 50 gambar/detik untuk moderasi gambar, 20 endpoint ingest/detik untuk moderasi video, 20 endpoint ingest/detik untuk moderasi audio, 100 entri/detik untuk moderasi teks, dan 10 gambar/detik untuk OCR gambar. Untuk menyesuaikan kuota, hubungi kami melalui Online Service. |
|
589 |
TOO_LARGE |
Konten yang akan dimoderasi terlalu besar. Pastikan konten berada dalam batas API. Coba ulang permintaan. Jika kode kesalahan ini terus muncul, hubungi kami melalui Online Service. |
|
590 |
BAD_FORMAT |
Format konten yang akan dimoderasi tidak valid. Pastikan konten berada dalam batas API. |
|
591 |
CONNECTION_POOL_FULL |
Kolam koneksi penuh. Hubungi kami melalui Online Service. |
|
592 |
DOWNLOAD_TIMEOUT |
Waktu pengunduhan habis. Batas waktu pengunduhan adalah 3 detik. Pastikan ukuran konten berada dalam batas API. |
|
594 |
EXPIRED |
Tugas kedaluwarsa. Misalnya, TaskId telah kedaluwarsa. |
|
595 |
CATCH_FRAME_FAILED |
Gagal menangkap frame. Hubungi kami melalui Online Service. |
|
596 |
PERMISSION_DENY |
Alasannya mencakup akun tidak memiliki otorisasi, terdapat Pembayaran tertunda, layanan belum diaktifkan untuk akun tersebut, atau akun dinonaktifkan. Untuk informasi lebih lanjut, lihat deskripsi kesalahan yang dikembalikan. |