Gunakan panduan ini untuk membantu Anda mendiagnosis dan menyelesaikan masalah umum yang muncul saat memanggil Gemini API. Jika Anda 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 penyebabnya dan langkah pemecahan masalahnya:
| Kode HTTP | Status | Deskripsi | Solusi |
| 400 | INVALID_ARGUMENT | Isi permintaan memiliki format yang salah. | 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. |
| 403 | PERMISSION_DENIED | Kunci API Anda tidak memiliki izin yang diperlukan. | Periksa apakah kunci API Anda telah disetel 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 diperlukan. |
| 500 | INTERNAL | Terjadi error yang tidak terduga di pihak Google. | Tunggu sebentar dan coba lagi permintaan Anda. Jika masalah berlanjut setelah mencoba lagi, laporkan menggunakan tombol Kirim masukan di Google AI Studio. |
| 503 | UNAVAILABLE | Layanan mungkin kelebihan beban untuk sementara atau tidak aktif. | Tunggu sebentar dan coba lagi permintaan Anda. Jika masalah berlanjut setelah mencoba lagi, laporkan menggunakan tombol Kirim masukan di Google AI Studio. |
Memeriksa panggilan API untuk 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 (mis., /v1 atau /v1beta) dan model yang mendukung fitur yang Anda perlukan. Misalnya, jika fitur masih dalam versi Beta, fitur hanya akan tersedia dalam versi API /v1beta.
Memeriksa apakah Anda memiliki model yang tepat
Pastikan Anda menggunakan model yang didukung. Gunakan list_models
(Python) untuk mendapatkan semua model
yang tersedia untuk digunakan.
Masalah keamanan
Jika Anda melihat permintaan diblokir karena setelan keamanan dalam panggilan API, tinjau 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. Halaman pengantar perintah desain 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 penyesuaian model.
Memahami batas token
Gunakan ModelService API untuk mendapatkan metadata
tambahan tentang model, termasuk batas token input
dan output.
Untuk mendapatkan token yang digunakan oleh perintah Anda, gunakan
countMessageTokens
untuk model chat dan
countTextTokens untuk
model teks.
Masalah umum
- Dukungan seluler untuk Google AI Studio: Meskipun Anda dapat membuka situs di perangkat seluler, situs belum dioptimalkan untuk layar kecil.
- API ini hanya mendukung bahasa Inggris. Mengirimkan perintah dalam berbagai bahasa dapat menghasilkan respons yang tidak terduga atau bahkan diblokir. Lihat bahasa yang tersedia untuk mendapatkan info terbaru.
Laporkan bug
Ajukan masalah di GitHub untuk mengajukan pertanyaan atau mengirimkan permintaan fitur atau bug.