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

# Google Gemini (opsional)

> API key dari Google AI Studio sebagai AI alternatif.

**Gemini** opsional di AI Mentor — dipakai jika `GEMINI_API_KEY` terisi dan flow memilih provider Gemini. Tanpa key, fitur yang butuh Gemini tidak aktif.

<Frame>
  <img src="https://ai.google.dev/static/site-assets/images/share-gemini-api-512.png" alt="Gemini API" width="120" />
</Frame>

**Console:** [aistudio.google.com](https://aistudio.google.com)\
**Docs:** [ai.google.dev/gemini-api](https://ai.google.dev/gemini-api/docs/api-key)

## Env di project

```bash theme={null}
GEMINI_API_KEY=AIza...
# atau GOOGLE_API_KEY (library Google mendeteksi keduanya)
```

## Setup

<Steps>
  <Step title="Buka Google AI Studio">
    [aistudio.google.com](https://aistudio.google.com) → login Google account
  </Step>

  <Step title="Buat API key">
    Menu → **API Keys** → **Create API key**\
    Pilih project Google Cloud (atau buat baru). Salin key `AIza...`
  </Step>

  <Step title="(Opsional) Import GCP project">
    Dashboard → **Projects** → **Import projects** jika pakai project Cloud existing
  </Step>

  <Step title="Tes di Playground">
    AI Studio → **Playground** → ketik prompt → Run — pastikan quota aktif
  </Step>

  <Step title="Masukkan ke .env">
    ```bash theme={null}
    GEMINI_API_KEY=AIza...
    ./thub env merge
    ./thub secrets push
    ```
  </Step>
</Steps>

## Auth key vs standard key

Google sedang migrasi ke **auth keys** (lebih aman). Key baru di AI Studio otomatis auth key. Docs: [Migrate to auth key](https://ai.google.dev/gemini-api/docs/api-key).

## Troubleshooting

| Masalah                  | Solusi                                         |
| ------------------------ | ---------------------------------------------- |
| API key invalid          | Regenerate di AI Studio                        |
| Quota exceeded           | Cek billing GCP / free tier limits             |
| Fitur tidak pakai Gemini | Normal — `AI_PROVIDER=deepseek` adalah default |

Docs: [AI Studio quickstart](https://ai.google.dev/gemini-api/docs/ai-studio-quickstart)