> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kiosapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini CLI

> Siapkan Gemini CLI dari Google untuk menggunakan KiosAPI sebagai penyedia backend.

# Gemini CLI

[Gemini CLI](https://github.com/google-gemini/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](https://kiosapi.com) → **Token Management**

## Instalasi

Instal Gemini CLI secara global melalui npm:

```bash theme={null}
npm install -g @google/gemini-cli
```

Verifikasi instalasi:

```bash theme={null}
gemini --version
```

## Dapatkan Kunci API Anda

1. Masuk ke [Dashboard KiosAPI](https://kiosapi.com)
2. Buka **Token Management**
3. Pilih grup **`Gemini`** (pengali 0.05×) lalu simpan dan salin kuncinya

> [!WARNING]
>
> Key dari grup lain tidak bisa memanggil model Gemini. Lihat [Memilih Grup Token](https://docs.kiosapi.com/getting-started/token-groups.md).

## Konfigurasi

### 1. Atur URL dasar

Buat `~/.gemini/.env`:

```bash theme={null}
GOOGLE_GEMINI_BASE_URL=https://kiosapi.com/
```

> [!NOTE]
>
> URL dasar harus diakhiri garis miring `/`. Gemini CLI menambahkan jalur API setelahnya.

### 2. Konfigurasikan pengaturan

Buat `~/.gemini/settings.json`:

```json theme={null}
{
  "auth": {
    "selectedType": "api-key"
  },
  "model": "gemini-3.8-flash",
  "models": {
    "gemini-3.8-flash": {
      "name": "Gemini 3.8 Flash",
      "base_url": "https://kiosapi.com/"
    },
    "gemini-3.7-flash": {
      "name": "Gemini 3.7 Flash",
      "base_url": "https://kiosapi.com/"
    },
    "gemini-3.6-flash": {
      "name": "Gemini 3.6 Flash",
      "base_url": "https://kiosapi.com/"
    }
  }
}
```

| Pengaturan | Deskripsi |
| - | - |
| `auth.selectedType` | Metode autentikasi — atur ke `api-key` untuk KiosAPI |
| `model` | Model default yang digunakan |
| `models` | Definisi model dengan nama tampilan dan URL dasar |

### 3. Jalankan Gemini CLI

Jalankan perintah berikut di terminal Anda:

```bash theme={null}
gemini
```

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

> [!WARNING]
>
> 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

```bash theme={null}
gemini
```

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

### Pertanyaan langsung

```bash theme={null}
gemini "What is the capital of France?"
```

### Dengan konteks file

```bash theme={null}
gemini "Explain this code" < main.py
```

## Mengganti Model

Ubah model default di `~/.gemini/settings.json`:

```json theme={null}
{
  "model": "gemini-3.8-flash"
}
```

Atau tentukan model per sesi:

```bash theme={null}
gemini --model gemini-3.8-flash "Summarize this article"
```

## Model Tersedia

| ID Model | Deskripsi |
| - | - |
| `gemini-3.8-flash` | Penalaran kompleks dan coding — default yang disarankan |
| `gemini-3.7-flash` | Tugas umum cepat |
| `gemini-3.6-flash` | Model ringan yang sangat cepat |

> [!TIP]
>
> Periksa [halaman harga KiosAPI](https://kiosapi.com/pricing) 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](https://docs.kiosapi.com/id/api-reference/models/list-models.md)

## Verifikasi Pengaturan

```bash theme={null}
gemini "Say hello"
```

## Butuh Bantuan?

* [Dashboard KiosAPI](https://kiosapi.com)
* [Memilih Grup Token](https://docs.kiosapi.com/getting-started/token-groups.md)
* [Model Tersedia](https://docs.kiosapi.com/id/api-reference/models/list-models.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.