Halaman ini diterjemahkan oleh Cloud Translation API.

Mulai gunakan Gemini

Halaman ini membantu developer menyiapkan project air-gapped Google Distributed Cloud (GDC) untuk menggunakan model Gemini. Proses ini mencakup pembuatan project, pengaktifan Gemini API, penginstalan library klien, penentuan variabel lingkungan, dan autentikasi kredensial Anda. Jika Anda baru menggunakan Gemini, pelajari lebih lanjut kemampuan Gemini.

Anda dapat mulai menggunakan Gemini dengan konsol GDC dan gdcloud CLI sebagai berikut:

Konsol GDC: Aktifkan Gemini API dan lihat status serta endpoint model.
gdcloud CLI: Konfigurasi akun layanan, instal library klien, dan autentikasi permintaan API.

Membuat project

Membuat project dalam hierarki resource Distributed Cloud mengatur resource Anda, yang mencakup kolaborator, API yang diaktifkan, kredensial autentikasi, dan kontrol akses.

Gemini adalah salah satu model AI Generatif yang ditawarkan oleh Vertex AI di GDC. Oleh karena itu, untuk membuat project, lihat Menyiapkan project untuk Vertex AI. Anda memerlukan project ID saat melakukan panggilan API.

Meminta izin developer

Anda harus memiliki peran yang sesuai di project untuk mengakses kemampuan Gemini dan membuat token API untuk autentikasi dan otorisasi permintaan.

Minta Admin IAM Project Anda untuk memberikan salah satu peran Gemini terkait kepada akun pengguna atau layanan Anda dalam namespace project Anda. Untuk mengetahui informasi tentang peran Gemini, lihat Siapkan izin IAM.

Mengaktifkan Gemini API

Anda harus mengaktifkan Gemini API untuk project Anda. Jika diaktifkan, Anda dapat melihat status layanan dan endpoint untuk Gemini API.

Menginstal library klien

Library klien tersedia untuk bahasa pemrograman Python. Sebaiknya gunakan library klien ini untuk melakukan panggilan ke Gemini API karena library tersebut memudahkan akses ke API.

Untuk menggunakan Python SDK yang kompatibel dengan OpenAI, instal OpenAI SDK dan library Python yang diperlukan lainnya:

pip install openai
pip install absl-py
pip install typing
pip install protobuf

Menetapkan variabel lingkungan

Setelah menginstal library klien, Anda dapat berinteraksi dengan API dari skrip Python.

Jika Anda menyiapkan akun layanan di project untuk membuat panggilan API yang sah secara terprogram, Anda dapat menentukan variabel lingkungan dalam skrip Python untuk mengakses nilai seperti kunci akun layanan.

Ikuti langkah-langkah berikut untuk menetapkan variabel lingkungan yang diperlukan pada skrip Python:

Buat skrip Python.
Tambahkan kode berikut ke skrip Python:
Produksi
```
import os

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"
```
Ganti APPLICATION_DEFAULT_CREDENTIALS_FILENAME dengan nama file JSON yang berisi kunci akun layanan yang Anda buat di project, seperti my-service-key.json.
Pengembangan
```
import os

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"
os.environ["GRPC_DEFAULT_SSL_ROOTS_FILE_PATH"] = "CERT_NAME"
```
Ganti kode berikut:
- APPLICATION_DEFAULT_CREDENTIALS_FILENAME: nama file JSON yang berisi kunci akun layanan yang Anda buat di project, seperti my-service-key.json.
- CERT_NAME: nama file sertifikat Certificate Authority (CA), seperti org-1-trust-bundle-ca.cert. Untuk mengetahui informasi selengkapnya, lihat Membuat file sertifikat CA paket kepercayaan di lingkungan pengembangan.
Simpan skrip Python dengan nama.
Jalankan skrip Python untuk menetapkan variabel lingkungan:
```
python SCRIPT_NAME
```
Ganti SCRIPT_NAME dengan nama yang Anda berikan ke skrip Python.

Menyiapkan autentikasi

Sebelum dapat mulai menggunakan Gemini API, Anda harus mengautentikasi kredensial klien dan meminta akses akun ke resource project Anda. Untuk mengetahui informasi selengkapnya, lihat Mengautentikasi permintaan API.