Gunakan panduan ini untuk membantu mendiagnosis dan menyelesaikan masalah umum yang muncul saat Anda memanggil Gemini API. Anda mungkin mengalami masalah dari layanan backend Gemini API atau SDK klien. SDK klien kami bersifat open source di repositori berikut:
Jika Anda mengalami masalah kunci API, pastikan Anda telah menyiapkan kunci API dengan benar sesuai dengan panduan penyiapan kunci API.
Kode error layanan backend Gemini API
Tabel berikut mencantumkan kode error backend umum yang mungkin Anda temui, beserta penjelasan penyebabnya dan langkah-langkah pemecahan masalahnya:
| Kode HTTP | Status | Deskripsi | Contoh | Solusi |
| 400 | INVALID_ARGUMENT | Isi permintaan salah format. | Ada kesalahan ketik, atau kolom wajib diisi tidak ada dalam permintaan Anda. | Periksa 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. Aktifkan penagihan di project Anda di Google AI Studio. | Anda membuat permintaan di wilayah tempat paket gratis tidak didukung, dan Anda belum mengaktifkan penagihan pada project di Google AI Studio. | Untuk menggunakan Gemini API, Anda harus menyiapkan paket berbayar menggunakan Google AI Studio. |
| 403 | PERMISSION_DENIED | Kunci API Anda tidak memiliki izin yang diperlukan. | Anda menggunakan kunci API yang salah; Anda mencoba menggunakan model yang disesuaikan tanpa melalui autentikasi yang tepat. | Pastikan kunci API Anda ditetapkan dan memiliki akses yang tepat. Selain itu, pastikan Anda melakukan autentikasi yang tepat untuk menggunakan model yang dioptimalkan. |
| 404 | NOT_FOUND | Resource yang diminta tidak ditemukan. | File gambar, audio, atau video yang dirujuk dalam permintaan Anda tidak ditemukan. | Periksa apakah semua parameter dalam permintaan Anda valid untuk versi API Anda. |
| 429 | RESOURCE_EXHAUSTED | Anda telah melampaui batas kapasitas. | Anda mengirim terlalu banyak permintaan per menit dengan Gemini API paket gratis. | Pastikan Anda berada dalam batas kapasitas model. Minta penambahan kuota jika diperlukan. |
| 500 | INTERNAL | Terjadi error yang tidak terduga di pihak Google. | Konteks input Anda terlalu panjang. | Kurangi konteks input atau beralihlah ke model lain untuk sementara (misalnya, dari Gemini 1.5 Pro ke Gemini 1.5 Flash) dan lihat apakah berfungsi. Atau tunggu sebentar dan coba lagi permintaan Anda. Jika masalah berlanjut setelah mencoba lagi, laporkan masalah tersebut menggunakan tombol Kirim masukan di Google AI Studio. |
| 503 | UNAVAILABLE | Layanan mungkin kelebihan beban atau tidak dapat diakses untuk sementara. | Layanan ini untuk sementara kehabisan kapasitas. | Beralihlah ke model lain untuk sementara (misalnya, dari Gemini 1.5 Pro ke Gemini 1.5 Flash) dan lihat apakah model tersebut berfungsi. Atau tunggu sebentar dan coba lagi permintaan Anda. Jika masalah berlanjut setelah mencoba lagi, laporkan masalah tersebut menggunakan tombol Kirim masukan di Google AI Studio. |
| 504 | DEADLINE_EXCEEDED | Layanan tidak dapat menyelesaikan pemrosesan dalam batas waktu. | Perintah (atau konteks) Anda terlalu besar untuk diproses tepat waktu. | Tetapkan 'waktu tunggu' yang lebih besar dalam permintaan klien Anda untuk menghindari error ini. |
Kode error SDK klien
Periksa panggilan API Anda 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 maksimum token untuk model yang Anda gunakan.
|
| TopP | 0.0-1.0 |
Selain memeriksa nilai parameter, pastikan Anda menggunakan
versi API yang benar (misalnya, /v1 atau /v1beta) dan
model yang mendukung fitur yang Anda butuhkan. Misalnya, jika fitur dalam rilis
Beta, fitur tersebut hanya akan tersedia dalam versi /v1beta API.
Memeriksa apakah Anda memiliki model yang tepat
Pastikan Anda menggunakan model yang didukung dan tercantum di halaman model kami.
Masalah keamanan
Jika Anda melihat perintah diblokir karena setelan keamanan dalam panggilan API, tinjau perintah tersebut sehubungan dengan filter yang Anda tetapkan dalam panggilan API.
Jika Anda melihat BlockedReason.OTHER, kueri atau respons mungkin melanggar persyaratan
layanan atau tidak didukung.
Masalah pengucapan
Jika Anda melihat model berhenti menghasilkan output karena alasan RECITATION, ini berarti output model mungkin menyerupai data tertentu. Untuk memperbaikinya, coba buat perintah / konteks se-unik mungkin dan gunakan suhu yang lebih tinggi.
Meningkatkan output model
Untuk output model yang lebih berkualitas, pelajari cara menulis perintah yang lebih terstruktur. Halaman pengantar desain perintah memperkenalkan beberapa konsep dasar, strategi, dan praktik terbaik untuk membantu Anda memulai.
Jika memiliki ratusan contoh pasangan input/output yang baik, Anda juga dapat mempertimbangkan penyesuaian model.
Memahami batas token
Baca Panduan token kami untuk lebih memahami cara menghitung token dan batasnya.
Masalah umum
- API ini hanya mendukung sejumlah bahasa tertentu. Mengirim perintah dalam bahasa yang tidak didukung dapat menghasilkan respons yang tidak terduga atau bahkan diblokir. Lihat bahasa yang tersedia untuk mengetahui info terbaru.
Laporkan bug
Ikuti diskusi di forum developer Google AI jika ada pertanyaan.