Mendapatkan kunci API Google Cloud

Untuk menggunakan Gemini di Vertex AI, Anda harus melakukan autentikasi menggunakan kunci APIGoogle Cloud atau menggunakan kredensial default aplikasi. Sebaiknya gunakan kunci API untuk pengujian dan gunakan kredensial default aplikasi untuk produksi. Halaman ini menunjukkan cara mendapatkan kunci API Google Cloud berdasarkan apakah Anda sudah memiliki akun Google Cloud atau belum.

Pilih apakah Anda memiliki akun Google Cloud :

Membuat Google Cloud kunci API

Jika Anda sudah memiliki akun Google Cloud , gunakan petunjuk berikut untuk mendapatkan kunci API Google Cloud standar. Atau, Anda dapat menggunakan kredensial default aplikasi, bukan menggunakan kunci API.

Sebelum memulai

Memilih project, mengaktifkan penagihan, mengaktifkan Vertex AI API

  1. Sign in to your Google Account.

    If you don't already have one, sign up for a new account.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Enable the API

    5.

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI API.

    Enable the API

    8.

Mengaktifkan pembuatan kunci API akun layanan

  1. Buka IAM & Admin > Kebijakan organisasi.
  2. Dalam daftar kebijakan, filter kebijakan yang disebut iam.managed.disableServiceAccountApiKeyCreation.
  3. Klik Tindakan > Edit kebijakan.
  4. Di bagian Sumber kebijakan, pilih Ganti kebijakan induk, lalu klik Tambahkan aturan.
  5. Di bagian Enforcement, pilih Off.
  6. Klik Selesai.
  7. Klik Set policy. Pada dialog yang muncul, klik Tetapkan kebijakan lagi.

Buat akun layanan baru

  1. Buka IAM & Admin > Service Accounts.
  2. Klik Create service account.
  3. Konfigurasikan akun layanan sebagai berikut:
    • Nama akun layanan: vertex-ai-runner
    • ID akun layanan: vertexairunner
  4. Klik Buat dan lanjutkan.
  5. Di bagian Permissions, klik Select a role, lalu pilih Vertex AI Platform Express User dari menu.
  6. Klik Lanjutkan.
  7. Klik Selesai.

Membuat kunci API

  1. Buka APIs & Services > Credentials.
  2. Klik Buat kredensial > Kunci API.
  3. Konfigurasikan kunci API sebagai berikut:
    • Nama: vertexaiapikey
    • Autentikasi panggilan API melalui akun layanan: Dipilih.
  4. Klik Select service account.
  5. Pilih akun layanan yang Anda buat di langkah sebelumnya, lalu klik Select.
  6. Klik Buat.

Membuat permintaan API pertama Anda

Setelah mendapatkan kunci API, pelajari cara menggunakan kunci API untuk membuat permintaan pertama Anda di panduan memulai API.

Opsional: Menyiapkan kunci API secara lokal

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.

Klik untuk meluaskan petunjuk

Linux/macOS

  1. Jalankan perintah berikut untuk melihat shell command line yang Anda gunakan:

    echo $SHELL

    Outputnya mirip dengan hal berikut ini:

    /bin/bash

  2. Tambahkan variabel ekspor shell untuk kunci API Anda, dengan melakukan salah satu hal berikut:

    • Jika output langkah sebelumnya adalah /bin/bash:

      1. Buka .bashrc:

        touch ~/.bashrc
        open ~/.bashrc

      2. Tambahkan baris berikut ke .bashrc:

        export GEMINI_API_KEY=YOUR_API_KEY

      3. Simpan file, lalu jalankan perintah berikut untuk menerapkan perubahan:

        source ~/.bashrc

    • Jika output langkah sebelumnya adalah /bin/zsh:

      1. Buka .zshrc:

        touch ~/.zshrc
        open ~/.zshrc

      2. Tambahkan baris berikut ke .zshrc:

        export GEMINI_API_KEY= YOUR_API_KEY

      3. Simpan file, lalu jalankan perintah berikut untuk menerapkan perubahan:

        source ~/.zshrc

Windows

  1. Telusuri "Variabel Lingkungan" 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_API_KEY
  4. Menerapkan perubahan