Skip to main content

 

Menggunakan kunci Gemini API

Untuk menggunakan Gemini API, Anda memerlukan kunci API. Halaman ini menguraikan cara membuat dan mengelola kunci Anda di Google AI Studio serta cara menyiapkan lingkungan untuk menggunakannya dalam kode Anda.

Kunci API adalah string terenkripsi yang dapat Anda gunakan saat memanggil Google Cloud API. Anda dapat membuat dan mengelola semua Kunci API Gemini dari halaman Kunci API Google AI Studio.

Setelah memiliki kunci API, Anda memiliki opsi berikut untuk terhubung ke Gemini API:

Untuk pengujian awal, Anda dapat meng-hard code kunci API, tetapi ini hanya boleh dilakukan untuk sementara karena tidak aman. Anda dapat menemukan contoh untuk meng-hardcode kunci API di bagian Memberikan kunci API secara eksplisit.

Project Google Cloud sangat penting untuk menggunakan layanan Google Cloud (seperti Gemini API), mengelola penagihan, serta mengontrol kolaborator dan izin. Google AI Studio menyediakan antarmuka ringan untuk project Google Cloud Anda.

Jika Anda belum membuat project, Anda harus membuat project baru atau mengimpor project dari Google Cloud ke Google AI Studio. Halaman Projects di Google AI Studio akan menampilkan semua kunci yang memiliki izin yang memadai untuk menggunakan Gemini API. Lihat bagian mengimpor project untuk mengetahui petunjuknya.

Setiap kunci Gemini API dikaitkan dengan project Google Cloud. Secara default, Google AI Studio tidak menampilkan semua Project Cloud Anda. Anda harus mengimpor project yang diinginkan dengan menelusuri nama atau project ID di dialog Impor Project. Untuk melihat daftar lengkap project yang aksesnya Anda miliki, buka Konsol Cloud.

Jika Anda belum mengimpor project, ikuti langkah-langkah berikut untuk mengimpor project Google Cloud dan membuat kunci:

  1. Buka Google AI Studio.
  2. Buka Dasbor dari panel samping kiri.
  3. Pilih Project.
  4. Pilih tombol Impor project di halaman Project.
  5. Cari dan pilih project Google Cloud yang ingin Anda impor, lalu pilih tombol Impor.

Setelah project diimpor, buka halaman Kunci API dari menu Dasbor, lalu buat kunci API di project yang baru saja Anda impor.

Berikut adalah batasan pengelolaan kunci API dan project Google Cloud di Google AI Studio.

  • Anda dapat membuat maksimal 10 project sekaligus dari halaman Projects di Google AI Studio.
  • Anda dapat memberi nama dan mengganti nama project dan kunci.
  • Halaman API keys dan Projects menampilkan maksimum 100 kunci dan 50 project.
  • Hanya kunci API yang tidak memiliki batasan, atau dibatasi untuk Generative Language API yang ditampilkan.

Untuk akses pengelolaan tambahan ke project Anda, buka Konsol Google Cloud.

Jika Anda menyetel variabel lingkungan GEMINI_API_KEY atau GOOGLE_API_KEY, kunci API akan otomatis diambil oleh klien saat menggunakan salah satu library Gemini API. Sebaiknya Anda menetapkan hanya salah satu variabel tersebut, tetapi jika keduanya ditetapkan, GOOGLE_API_KEY akan diprioritaskan.

Jika menggunakan REST API, atau JavaScript di browser, Anda harus memberikan kunci API secara eksplisit.

Berikut cara menetapkan kunci API Anda secara lokal sebagai variabel lingkungan GEMINI_API_KEY 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 untuk cluster tersebut dengan menjalankan perintah berikut:

~/.bashrc

Jika responsnya adalah "No such file or directory", 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

Dalam beberapa kasus, Anda mungkin ingin memberikan kunci API secara eksplisit. Contoh:

  • Anda melakukan panggilan API sederhana dan lebih memilih untuk meng-hardcode kunci API.
  • Anda menginginkan kontrol eksplisit tanpa harus mengandalkan penemuan otomatis variabel lingkungan oleh library Gemini API
  • Anda menggunakan lingkungan yang tidak mendukung variabel lingkungan (misalnya web) atau Anda melakukan panggilan REST.

Berikut adalah contoh cara memberikan kunci API secara eksplisit:

PythonJavaScript
from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

response = client.models.generate_content(
    model="gemini-2.5-flash", contents="Explain how AI works in a few words"
)
print(response.text)

Perlakukan kunci Gemini API Anda seperti sandi. Jika disusupi, orang lain dapat menggunakan kuota project Anda, dikenai biaya (jika penagihan diaktifkan), dan mengakses data pribadi Anda, seperti file.

  • Jangan pernah melakukan commit kunci API ke kontrol sumber. Jangan masukkan kunci API Anda ke dalam sistem kontrol versi seperti Git.

  • Jangan pernah menampilkan kunci API di sisi klien. Jangan gunakan kunci API Anda secara langsung di aplikasi web atau seluler dalam produksi. Kunci dalam kode sisi klien (termasuk library JavaScript/TypeScript dan panggilan REST kami) dapat diekstrak.

  • Gunakan panggilan sisi server dengan kunci API Cara paling aman untuk menggunakan kunci API Anda adalah dengan memanggil Gemini API dari aplikasi sisi server tempat kunci dapat dirahasiakan.

  • Menggunakan token sementara untuk akses sisi klien (khusus Live API): Untuk akses sisi klien langsung ke Live API, Anda dapat menggunakan token sementara. Versi ini memiliki risiko keamanan yang lebih rendah dan dapat cocok untuk penggunaan produksi. Tinjau panduan token sementara untuk mengetahui informasi selengkapnya.

  • Pertimbangkan untuk menambahkan batasan pada kunci Anda: Anda dapat membatasi izin kunci dengan menambahkan pembatasan kunci API. Tindakan ini akan meminimalkan potensi kerusakan jika kunci bocor.

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

Comments

Post a Comment

Popular posts from this blog

Image
  Langsung ke konten utama Masuk Model audio native baru tersedia untuk Live API.  Pelajari lebih lanjut Halaman ini diterjemahkan oleh  Cloud Translation API . Switch to English Beranda Gemini API Model Apakah informasi ini membantu? Kirim masukan Pembuatan teks Gemini API dapat menghasilkan output teks dari berbagai input, termasuk teks, gambar, video, dan audio, dengan memanfaatkan model Gemini. Berikut adalah contoh dasar yang menggunakan satu input teks: Python JavaScript Lainnya from google import genai client = genai . Client () response = client . models . generate_content ( model = "gemini-2.5-flash" , contents = "How does AI work?" ) print ( response . text ) Berpikir dengan Gemini 2. 5 Model 2.5 Flash dan Pro mengaktifkan  "pemikiran"  secara default untuk meningkatkan kualitas, yang mungkin memerlukan waktu lebih lama untuk dijalankan dan meningkatkan penggunaan token. Saat menggunakan Flash 2.5, Anda dapat menonaktifkan...
Read more

IT Dev

Image
  Pengembangan TI: Produktivitas AI dan Integrasi API AI untuk Pengembang Membuat Aplikasi Gemini AI ChatBot Gambar tersebut menampilkan tabel yang berisi daftar alat atau  tools  yang digunakan oleh pengembang TI ( IT Developer ) . Beberapa alat umum pengembang perangkat lunak yang digunakan meliputi: Visual Studio Code : Editor kode yang populer untuk berbagai bahasa pemrograman. Git dan GitHub/GitLab/Bitbucket : Sistem kontrol versi dan platform kolaborasi untuk mengelola kode sumber. Docker : Platform untuk membangun, berbagi, dan menjalankan aplikasi dalam wadah ( container ). Jira : Alat pelacakan masalah dan manajemen proyek untuk tim Agile. Tukang pos : Alat untuk menguji dan mengembangkan API. Chrome DevTools : Kumpulan alat pengembang web yang terintegrasi di browser Google Chrome untuk mengedit halaman dan mendiagnosis masalah. Eclipse  dan  IntelliJ IDEA : Lingkungan pengembangan terintegrasi (IDE) yang sering digunakan, terutama untuk peng...
Read more

cara menginstal dan menggunakan npm dotenv

Image
  Produk Kesalahan konfigurasi Dokumen Sumber daya Harga Perusahaan Bintangi Kami 1,7 ribu Login Dapatkan secara gratis Apa itu npm dotenv dan bagaimana cara menginstal dan menggunakan npm dotenv? Tim Editorial Configu | 6 Maret 2024  |  Panduan Teknis Apa itu npm dotenv?  dotenv  adalah modul tanpa ketergantungan, tersedia melalui pengelola paket npm, yang memuat variabel lingkungan dari sebuah  .env berkas ke dalam  process.env . Sebagai pengembang Node.js, Anda mungkin familier dengan  process.env objek global yang disediakan oleh Node.js saat runtime. Objek ini digunakan untuk menyimpan pengaturan khusus lingkungan seperti kata sandi basis data, kunci API, atau bahkan port tempat aplikasi Anda harus dijalankan. Paket npm dotenv memungkinkan Anda mengelola pengaturan ini secara efisien, tanpa harus memasukkannya ke dalam aplikasi Anda melalui hard-code. Ini berguna saat menangani data sensitif yang tidak boleh diungkapkan, seperti kunci API rah...
Read more