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 kunci API Anda tetap aman

Sangat penting untuk menjaga keamanan kunci Gemini API Anda. Berikut adalah beberapa hal yang perlu diperhatikan saat menggunakan kunci Gemini API:

  • Gemini API AI Google menggunakan kunci API untuk otorisasi. Jika orang lain mendapatkan akses ke kunci Gemini API Anda, mereka dapat melakukan panggilan dengan 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 Dapatkan kunci API di Google AI Studio, Anda dapat memilih apakah akan menyediakan kunci Gemini API di project Google Cloud baru atau yang sudah ada. Tujuan Daftar kunci API di Google AI Studio menunjukkan semua kunci API yang disediakan AI Studio untuk digunakan dengan AI Gemini API (beserta semua project Google Cloud yang terkait).

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

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

    • Jika ada kunci API dalam project Google Cloud Anda yang tidak memiliki API kunci API apa pun yang telah mengizinkan Bahasa Generatif API tersebut, maka kunci tersebut dapat digunakan dengan Gemini API AI Google. Yang terbaik Anda untuk membatasi setiap kunci API hanya ke API yang Anda panggil menggunakan tombol.
    • Perhatikan bahwa meskipun dengan pembatasan kunci API, jika pelaku kejahatan memperoleh Kunci API ini dapat digunakan untuk melakukan panggilan dengan kuota project Anda untuk semua API yang diizinkan untuk kunci API tersebut.

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

    • JANGAN memeriksa kunci Gemini API untuk beralih ke kontrol sumber.
    • Risiko pada aplikasi sisi klien (Android, Swift, web, dan Dart/Flutter) mengekspos kunci API, jadi sebaiknya jangan gunakan SDK klien AI Google di aplikasi produksi untuk memanggil Gemini API AI Google langsung dari aplikasi seluler dan web. Lihat panduan memulai SDK untuk mempelajari praktik terbaik khusus bahasa untuk mengamankan kunci API Anda.

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

Langkah berikutnya

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