Gunakan panduan ini untuk membantu Anda mendiagnosis dan menyelesaikan masalah umum yang muncul saat Anda memanggil Gemini API. Jika mengalami masalah kunci API, pastikan Anda telah menyiapkan kunci API dengan benar sesuai dengan panduan penyiapan kunci API.
Kode error
Tabel berikut mencantumkan kode error umum yang mungkin Anda temui, beserta penjelasan tentang penyebabnya dan langkah pemecahan masalah:
| Kode HTTP | Status | Deskripsi | Solusi |
| 400 | INVALID_ARGUMENT | Isi permintaan memiliki format yang salah. | Lihat referensi API untuk mengetahui format permintaan, contoh, dan versi yang didukung. Menggunakan fitur dari versi API yang lebih baru dengan endpoint yang lebih lama dapat menyebabkan error. |
| 400 | FAILED_PRECONDITION | Lokasi pengguna tidak didukung untuk penggunaan API jika akun penagihan tidak ditautkan. | Untuk menggunakan Gemini API, Anda perlu menyiapkan paket berbayar menggunakan Google AI Studio. |
| 403 | PERMISSION_DENIED | Kunci API Anda tidak memiliki izin yang diperlukan. | Pastikan kunci API Anda sudah ditetapkan dan memiliki akses yang benar. |
| 404 | NOT_FOUND | Resource yang diminta tidak ditemukan. | Periksa apakah semua parameter dalam permintaan Anda valid untuk versi API Anda. |
| 429 | RESOURCE_EXHAUSTED | Anda telah melampaui batas nilai. | Pastikan Anda tidak melebihi batas kapasitas model. Minta penambahan kuota jika perlu. |
| 500 | INTERNAL | Terjadi kesalahan yang tidak terduga di pihak Google. | Tunggu sebentar dan coba lagi permintaan Anda. Jika masalah terus berlanjut setelah mencoba lagi, laporkan menggunakan tombol Kirim masukan di Google AI Studio. |
| 503 | UNAVAILABLE | Layanan mungkin kelebihan beban atau tidak aktif untuk sementara. | Tunggu sebentar dan coba lagi permintaan Anda. Jika masalah terus berlanjut setelah mencoba lagi, laporkan menggunakan tombol Kirim masukan di Google AI Studio. |
Memeriksa panggilan API untuk menemukan error parameter model
Pastikan parameter model Anda berada dalam nilai berikut:
| Parameter model | Nilai (rentang) |
| Jumlah kandidat | 1-8 (bilangan bulat) |
| Temperature (suhu) | 0,0-1,0 |
| Token output maks |
Gunakan get_model (Python) untuk menentukan jumlah token maksimum untuk model yang Anda gunakan.
|
| TopP | 0,0-1,0 |
Selain memeriksa parameter value, pastikan Anda menggunakan versi API yang benar (misalnya, /v1 atau /v1beta) dan model yang mendukung fitur yang Anda perlukan. Misalnya, jika suatu fitur berada dalam rilis Beta, fitur tersebut hanya akan tersedia dalam versi API /v1beta.
Periksa apakah Anda memiliki model yang tepat
Pastikan Anda menggunakan model yang didukung yang tercantum di halaman model kami.
Masalah keamanan
Jika Anda melihat perintah diblokir karena setelan keamanan di panggilan API Anda, tinjau dialog tersebut sehubungan dengan filter yang Anda tetapkan dalam panggilan API.
Jika Anda melihat BlockedReason.OTHER, berarti kueri atau respons tersebut mungkin melanggar persyaratan layanan atau tidak didukung.
Meningkatkan output model
Untuk output model yang berkualitas lebih tinggi, pelajari cara menulis perintah yang lebih terstruktur. Halaman pengantar desain prompt memperkenalkan beberapa konsep dasar, strategi, dan praktik terbaik untuk membantu Anda memulai.
Jika Anda memiliki ratusan contoh pasangan input/output yang baik, Anda juga dapat mempertimbangkan tuning model.
Memahami batas token
Baca Panduan token kami untuk lebih memahami cara menghitung token dan batasnya.
Masalah umum
- API ini hanya mendukung bahasa Inggris. Mengirimkan perintah dalam bahasa lain dapat menghasilkan respons yang tidak terduga atau bahkan diblokir. Lihat bahasa yang tersedia untuk mengetahui info terbaru.
Laporkan bug
Ikuti diskusi di forum developer AI Google jika Anda memiliki pertanyaan.