Gunakan panduan ini untuk membantu Anda mendiagnosis dan menyelesaikan masalah umum yang muncul saat dengan memanggil Gemini API. Jika mengalami masalah kunci API, pastikan Anda telah menyiapkan kunci API Anda dengan benar sesuai dengan panduan penyiapan kunci API.
Kode error
Tabel berikut mencantumkan kode error umum yang mungkin Anda temui, bersama dengan penjelasan mengenai penyebab dan langkah pemecahan masalah tersebut:
| 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 | Paket gratis Gemini API tidak tersedia di negara Anda. Harap aktifkan penagihan pada project Anda di Google AI Studio. | 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) |
| 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 nilai parameter, pastikan Anda menggunakan parameter
Versi API (mis., /v1 atau /v1beta) dan
yang mendukung fitur
yang Anda butuhkan. Misalnya, jika suatu fitur masih dalam versi Beta
rilis ini 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.
Masalah keamanan
Jika Anda melihat prompt diblokir karena pengaturan keamanan di panggilan API Anda, meninjau perintah sehubungan dengan filter yang Anda tetapkan dalam panggilan API.
Jika Anda melihat BlockedReason.OTHER, kueri atau respons mungkin melanggar persyaratan
layanan atau tidak didukung.
Meningkatkan output model
Untuk output model yang berkualitas lebih tinggi, pelajari cara menulis perintah yang lebih terstruktur. Tujuan halaman pengantar untuk desain prompt memperkenalkan beberapa konsep dasar, strategi, dan praktik terbaik untuk memulai.
Jika Anda memiliki ratusan contoh pasangan input/{i>output<i} yang baik, Anda juga dapat pertimbangkan tuning model.
Memahami batas token
Baca Panduan token kami untuk lebih memahami cara untuk menghitung token dan batasnya.
Masalah umum
- API ini hanya mendukung bahasa Inggris. Mengirim perintah dalam berbagai bahasa dapat menghasilkan respons yang tak terduga atau bahkan terhalang. Lihat tersedia bahasa untuk pembaruan.
Laporkan bug
Gabung dengan diskusi di forum developer AI Google jika ada pertanyaan.