Langsung ke konten utama

Gemini CLI

Gemini CLI adalah antarmuka baris perintah resmi Google untuk berinteraksi dengan model Gemini. Panduan ini menjelaskan cara mengonfigurasikannya agar menggunakan KiosAPI.

Prasyarat

  • Node.js 18+ — periksa dengan node --version
  • Kunci API KiosAPI (diawali dengan sk-) dari Dashboard → Token Management

Instalasi

Instal Gemini CLI secara global melalui npm:
Verifikasi instalasi:

Dapatkan Kunci API Anda

  1. Masuk ke Dashboard KiosAPI
  2. Buka Token Management
  3. Pilih grup Gemini (pengali 0.05×) lalu simpan dan salin kuncinya
Key dari grup lain tidak bisa memanggil model Gemini. Lihat Memilih Grup Token.

Konfigurasi

1. Atur URL dasar

Buat ~/.gemini/.env:
URL dasar harus diakhiri garis miring /. Gemini CLI menambahkan jalur API setelahnya.

2. Konfigurasikan pengaturan

Buat ~/.gemini/settings.json:

3. Jalankan Gemini CLI

Jalankan perintah berikut di terminal Anda:
Pada peluncuran pertama, Gemini CLI akan meminta Anda memilih metode autentikasi:
  1. Pilih API Key
  2. Masukkan kunci KiosAPI Anda (sk-xxx)
  3. Tekan Enter untuk mengonfirmasi
Jangan pilih “Google Login”. Opsi ini mencoba mengautentikasi langsung ke server Google dan tidak akan berfungsi dengan KiosAPI. Selalu pilih API Key.

Penggunaan

Mode interaktif

Ini membuka REPL interaktif untuk mengobrol dengan Gemini, memintanya membaca file, dan menjalankan tugas.

Pertanyaan langsung

Dengan konteks file

Mengganti Model

Ubah model default di ~/.gemini/settings.json:
Atau tentukan model per sesi:

Model Tersedia

Periksa halaman harga KiosAPI untuk daftar lengkap model Gemini yang tersedia beserta biayanya.

Pemecahan Masalah

Autentikasi Gagal

  • Pastikan Anda memilih API Key (bukan Google Login) saat penyiapan
  • Pastikan kunci API Anda benar dan diawali dengan sk-
  • Jalankan kembali gemini dan pilih ulang metode autentikasi

Kesalahan Koneksi

  • Periksa bahwa GOOGLE_GEMINI_BASE_URL di ~/.gemini/.env adalah https://kiosapi.com/ (dengan garis miring akhir)
  • Pastikan base_url di settings.json juga memiliki garis miring akhir
  • Periksa koneksi jaringan Anda

Model Tidak Ditemukan

  • Periksa bahwa ID model sama persis (misalnya gemini-3.8-flash, bukan gemini-pro)
  • Konfirmasikan model tersedia di KiosAPI melalui daftar model

Verifikasi Pengaturan

Butuh Bantuan?