Pemecahan masalah Gemini
Antarmuka yang kompatibel dengan Gemini dan OpenAI bukanlah hal yang sama. Konfigurasikan sesuai Gemini hanya jika penyedia secara eksplisit menyediakan antarmuka terkait Gemini / Google / Vertex, atau tutorial dengan jelas menyatakan dukungan untuk Gemini CLI.
Apa yang harus dipastikan terlebih dahulu?
| Item pemeriksaan | Cara memeriksa | Alasan |
|---|---|---|
| Alat Target | Pastikan Anda sedang memecahkan masalah Gemini CLI | Metode autentikasi untuk Gemini CLI berbeda dari Codex dan Claude Code |
| Penyedia mendukung Gemini | Terdapat entri terkait Gemini / Google / Vertex di backend atau tutorial | Antarmuka yang kompatibel dengan OpenAI tidak sama dengan antarmuka Gemini |
| Tipe Key | Gunakan Key yang sesuai untuk Gemini atau Vertex | Jika tipe Key salah, Anda mungkin mendapatkan 401, 403, atau diminta untuk login berulang kali |
| Nama Model | Isi sesuai dengan daftar model Gemini | Jangan masukkan nama model OpenAI atau Claude di Gemini |
Kesalahan umum
| Gejala | Pemeriksaan prioritas | Solusi |
|---|---|---|
| Masih meminta untuk login ke Google | Autentikasi mandiri Gemini CLI | Selesaikan autentikasi yang diminta oleh Gemini CLI terlebih dahulu; konfigurasi penyedia tidak dapat menggantikan proses login yang diwajibkan oleh alat target itu sendiri. |
| 401 / 403 | Key atau izin Gemini | Pastikan Key termasuk dalam grup Gemini / Google / Vertex, dan proyek atau akun saat ini memiliki izin untuk model terkait. |
| 404 / model not found | Nama model Gemini | Isi sesuai dengan daftar model Gemini di backend penyedia; jangan masukkan nama model OpenAI atau Claude. |
| Koneksi gagal | Base URL Gemini | Jangan masukkan Base URL standar yang kompatibel dengan OpenAI di Gemini; hanya konfigurasikan jika backend secara eksplisit menyatakan dukungan untuk Gemini. |
| Tidak ada perubahan setelah beralih CC-Switch | Alat target dan status terminal | Pastikan target aplikasi adalah Gemini CLI, simpan, lalu buka kembali terminal dan uji lagi. |
Pengujian minimal
Pastikan terlebih dahulu bahwa Gemini CLI dapat mengembalikan kalimat pendek tertentu, lalu lanjutkan pemecahan masalah untuk tugas yang lebih kompleks.
Pengujian minimal Gemini
gemini "Please reply only: Gemini configuration test successful"Templat masukan
Saat memberikan masukan kepada penyedia, tulis seperti ini
Tool: Gemini System version: Provider dashboard Base URL: Model ID / model name: Exact error: I have checked: no spaces in the Key / balance is sufficient / model name copied exactly / Base URL copied from the dashboard / terminal reopened