Mendapatkan kunci Gemini API

Untuk menggunakan Gemini API, Anda memerlukan kunci API. Anda dapat membuat kunci dengan beberapa klik di Google AI Studio.

Mendapatkan kunci Gemini API di Google AI Studio

Menyiapkan kunci API

Untuk pengujian awal, Anda dapat melakukan hard code pada kunci API, tetapi ini hanya boleh sementara karena tidak aman. Bagian lainnya dalam bagian ini membahas cara menyiapkan kunci API secara lokal sebagai variabel lingkungan dengan sistem operasi yang berbeda.

Linux/macOS - Bash

Bash adalah konfigurasi terminal Linux dan macOS yang umum. Anda dapat memeriksa apakah Anda memiliki file konfigurasi untuknya dengan menjalankan perintah berikut:

~/.bashrc

Jika responsnya adalah "Tidak ada file atau direktori tersebut", Anda harus membuat file ini dan membukanya dengan menjalankan perintah berikut, atau menggunakan zsh:

touch ~/.bashrc
open ~/.bashrc

Selanjutnya, Anda perlu menetapkan kunci API dengan menambahkan perintah ekspor berikut:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Setelah menyimpan file, terapkan perubahan dengan menjalankan:

source ~/.bashrc

macOS - Zsh

Zsh adalah konfigurasi terminal Linux dan macOS yang umum. Anda dapat memeriksa apakah Anda memiliki file konfigurasi untuknya dengan menjalankan perintah berikut:

~/.zshrc

Jika responsnya adalah "Tidak ada file atau direktori tersebut", Anda harus membuat file ini dan membukanya dengan menjalankan perintah berikut, atau menggunakan bash:

touch ~/.zshrc
open ~/.zshrc

Selanjutnya, Anda perlu menetapkan kunci API dengan menambahkan perintah ekspor berikut:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Setelah menyimpan file, terapkan perubahan dengan menjalankan:

source ~/.zshrc

Windows

  1. Telusuri "Environment Variables" di setelan sistem
  2. Edit "User variables" (untuk pengguna saat ini) atau "System variables" (untuk semua pengguna - gunakan dengan hati-hati).
  3. Buat variabel dan tambahkan export GEMINI_API_KEY=your_key_here
  4. Menerapkan perubahan

Mengirim permintaan Gemini API pertama Anda

Anda dapat menggunakan perintah curl untuk memverifikasi penyiapan:

  curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=${GEMINI_API_KEY}" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts":[{"text": "Write a story about a magic backpack."}]
        }]
       }'

Menjaga kunci API Anda tetap aman

Anda harus menjaga keamanan kunci Gemini API Anda. Berikut beberapa hal yang perlu diingat saat menggunakan kunci Gemini API:

  • Google AI Gemini API menggunakan kunci API untuk otorisasi. Jika orang lain mendapatkan akses ke kunci Gemini API Anda, mereka dapat melakukan panggilan menggunakan kuota project Anda, yang dapat mengakibatkan hilangnya kuota atau tagihan tambahan untuk project yang ditagih, selain mengakses model dan file yang dioptimalkan.

  • Menambahkan pembatasan kunci API dapat membantu membatasi area permukaan yang dapat digunakan melalui setiap kunci API.

  • Anda bertanggung jawab untuk menjaga keamanan kunci Gemini API Anda.

    • JANGAN periksa kunci Gemini API ke dalam kontrol sumber.
    • Aplikasi sisi klien (Android, Swift, web, dan Dart/Flutter) berisiko mengekspos kunci API. Sebaiknya jangan gunakan SDK klien Google AI dalam aplikasi produksi untuk memanggil Google AI Gemini API langsung dari aplikasi seluler dan web Anda.

Untuk beberapa praktik terbaik umum, Anda juga dapat meninjau artikel dukungan ini.