Mendapatkan kunci API

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

Mendapatkan kunci API

Memverifikasi kunci API dengan perintah curl

Anda dapat menggunakan perintah curl untuk memverifikasi penyiapan. Anda dapat meneruskan kunci API di URL:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent?key=${API_KEY}"

Atau di header x-goog-api-key:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -H "x-goog-api-key: ${API_KEY}" \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent"

Menjaga keamanan kunci API

Anda harus menjaga keamanan kunci API Gemini. Berikut adalah 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 biaya penagihan tambahan (jika penagihan diaktifkan). Kunci API juga menjaga akses ke model dan file yang telah disesuaikan.

  • Saat mengklik Get API key di Google AI Studio, Anda dapat memilih apakah akan menyediakan kunci Gemini API di project Google Cloud yang baru atau yang sudah ada. Daftar kunci API di Google AI Studio menampilkan semua kunci API yang telah disediakan AI Studio untuk digunakan dengan Google AI Gemini API (beserta semua project Google Cloud terkait).

    • Namun, kunci API apa pun dalam project Google Cloud dapat berpotensi digunakan untuk memanggil Google AI Gemini API. Anda dapat melihat dan mengelola semua kunci API project di panel API & Layanan > Credentials di Konsol Google Cloud.

  • Menambahkan pembatasan kunci API dapat membantu membatasi area platform yang dapat digunakan melalui setiap kunci API. Secara default, kunci Gemini API yang dihasilkan oleh Google AI Studio hanya dapat digunakan dengan Google AI Gemini API (secara resmi disebut "Generative Language API" atau generativelanguage.googleapis.com).

    • Jika ada kunci API dalam project Google Cloud Anda yang tidak memiliki pembatasan API atau kunci API yang telah mengizinkan Generative Language API, maka kunci tersebut dapat digunakan dengan Google AI Gemini API. Praktik terbaiknya adalah membatasi setiap kunci API hanya ke API yang Anda panggil menggunakan kunci tersebut.
    • Perlu diperhatikan bahwa meskipun dengan pembatasan kunci API, jika pelaku kejahatan memperoleh kunci API Anda, mereka dapat menggunakannya untuk melakukan panggilan menggunakan kuota project Anda untuk semua API yang diizinkan untuk kunci API tersebut.

  • Anda bertanggung jawab untuk menjaga keamanan kunci API Gemini.

    • JANGAN memasukkan kunci API Gemini ke dalam kontrol sumber.
    • Aplikasi sisi klien (Android, Swift, web, dan Dart/Flutter) berisiko mengekspos kunci API. Oleh karena itu, sebaiknya jangan gunakan SDK klien Google AI dalam aplikasi produksi untuk memanggil Google AI Gemini API langsung dari aplikasi seluler dan web Anda. Lihat panduan memulai SDK guna mempelajari praktik terbaik khusus bahasa untuk mengamankan kunci API.

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

Langkah berikutnya

  • Lihat panduan memulai API guna mempelajari praktik terbaik untuk mengamankan kunci API dan menggunakannya.