Halaman ini menunjukkan cara untuk mulai mengirim permintaan ke Vertex AI Gemini API dengan cepat menggunakan Konsol Google Cloud, SDK bahasa pemrograman, atau REST API.
Baru menggunakan Google Cloud
Melakukan penyiapan di Google Cloud
Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload. Proses penyiapannya hanya memerlukan tiga langkah singkat:
Gunakan tombol berikut untuk membuat akun. Setelah selesai, kembali ke halaman ini untuk menyelesaikan tutorial pemula ini. Untuk menggunakan semua fitur yang tersedia di situs ini, login menggunakan akun Anda.
Buat akunUntuk mengetahui informasi selengkapnya tentang cara melakukan penyiapan di Google Cloud, lihat Melakukan penyiapan di Google Cloud.
Mengirim permintaan ke Vertex AI Gemini API
Untuk melihat petunjuk cara mengirim permintaan ke Vertex AI Gemini API, pilih salah satu tab berikut:
Python
-
Di konsol Google Cloud, aktifkan Cloud Shell.
Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.
Di Cloud Shell, instal atau update Vertex AI SDK untuk Python dengan menjalankan perintah berikut:
pip install "google-cloud-aiplatform>=1.38"
Kirim permintaan perintah. Ganti PROJECT_ID dengan ID project Google Cloud Anda.
Untuk mempelajari cara menginstal atau mengupdate Vertex AI SDK untuk Python, lihat Menginstal Vertex AI SDK untuk Python. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Vertex AI SDK untuk Python API.
Node.js
-
Di konsol Google Cloud, aktifkan Cloud Shell.
Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.
Di Cloud Shell, instal atau update Vertex AI SDK untuk Node.js dengan menjalankan perintah berikut:
npm install @google-cloud/vertexai
Kirim permintaan perintah. Ganti PROJECT_ID dengan ID project Google Cloud Anda.
Untuk mengetahui informasi selengkapnya tentang penginstalan dan penggunaan Vertex AI Node.js SDK, lihat dokumentasi referensi Vertex AI SDK untuk Node.js.
Java
- Menyiapkan Java Development Environment.
Autentikasi dengan menjalankan perintah berikut. Ganti PROJECT_ID dengan project ID Google Cloud Anda dan ACCOUNT dengan nama pengguna Google Cloud Anda.
gcloud config set project PROJECT_ID && gcloud auth login ACCOUNT
Tambahkan
google-cloud-vertexai
sebagai dependensi Anda:<!--If you are using Maven with BOM, add the following in your pom.xml--> <dependencyManagement> <dependencies> <dependency> <groupId>com.google.cloud</groupId> <artifactId>libraries-bom</artifactId> <version>26.32.0</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> <dependencies> <dependency> <groupId>com.google.cloud</groupId> <artifactId>google-cloud-vertexai</artifactId> </dependency> </dependencies> <!--If you are using Maven without BOM, add the following to your pom.xml--> <dependency> <groupId>com.google.cloud</groupId> <artifactId>google-cloud-vertexai</artifactId> <version>0.4.0</version> </dependency> <!--If you are using Gradle without BOM, add the following to your build.gradle--> implementation 'com.google.cloud:google-cloud-vertexai:0.4.0'
Kirim permintaan perintah. Tetapkan projectID
ke project ID Google Cloud Anda.
Untuk mengetahui informasi selengkapnya tentang penginstalan dan penggunaan Java Development Kit (JDK) Vertex AI, lihat dokumentasi referensi Vertex AI JDK.
Go
- Siapkan lingkungan Anda untuk pengembangan Go.
Tinjau paket Vertex AI API Go yang tersedia untuk menentukan paket mana yang paling sesuai dengan kebutuhan project Anda:
Paket cloud.google.com/go/vertexai (direkomendasikan)
vertexai
adalah paket yang ditulis manusia yang memberikan akses ke kemampuan dan fitur umum.Paket ini direkomendasikan sebagai titik awal bagi sebagian besar developer yang membangun aplikasi dengan Vertex AI API. Untuk mengakses kemampuan dan fitur yang belum dicakup oleh paket ini, gunakan
aiplatform
yang dihasilkan secara otomatis.Paket: cloud.google.com/go/aiplatform
aiplatform
adalah paket yang dibuat secara otomatis.Paket ini ditujukan untuk project yang memerlukan akses ke kemampuan dan fitur Vertex AI API yang belum disediakan oleh paket
vertexai
buatan manusia.
Instal paket Go yang diinginkan berdasarkan kebutuhan project Anda dengan menjalankan salah satu perintah berikut:
# Human authored package. Recommended for most developers. go get cloud.google.com/go/vertexai
# Auto-generated package. go get cloud.google.com/go/aiplatform
Kirim permintaan perintah. Ganti PROJECT_ID dengan ID project Google Cloud Anda.
Untuk mengetahui informasi selengkapnya tentang cara menginstal dan menggunakan Vertex AI SDK untuk Go, lihat dokumentasi referensi Vertex AI SDK untuk Go.
C#
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan C# di Panduan memulai Vertex AI menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API C# Vertex AI.
Untuk melakukan autentikasi ke Vertex AI, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
REST
-
Di konsol Google Cloud, aktifkan Cloud Shell.
Konfigurasikan variabel lingkungan dengan memasukkan perintah berikut. Ganti PROJECT_ID dengan ID project Google Cloud Anda.
MODEL_ID="gemini-1.0-pro-vision" PROJECT_ID="PROJECT_ID"
Sediakan endpoint:
gcloud beta services identity create --service=aiplatform.googleapis.com --project=PROJECT_ID
Kirim permintaan perintah dengan memasukkan perintah curl berikut:
curl \ -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json" \ https://us-central1-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/us-central1/publishers/google/models/${MODEL_ID}:streamGenerateContent -d \ $'{ "contents": { "role": "user", "parts": [ { "fileData": { "mimeType": "image/jpeg", "fileUri": "gs://generativeai-downloads/images/scones.jpg" } }, { "text": "Describe this picture." } ] } }'
Jika diminta untuk memberikan otorisasi pada Cloud Shell, klik Authorize.
Model akan menampilkan respons. Perhatikan bahwa respons dibuat di bagian dengan setiap bagian dievaluasi secara terpisah demi keamanan.
Konsol
Gunakan Vertex AI Studio untuk mendesain dan melakukan iterasi pada perintah Anda dengan cepat. Setelah perintah siap, Anda bisa mendapatkan kode untuk perintah tersebut dalam bahasa pemrograman yang didukung.
Di konsol Google Cloud, buka halaman Vertex AI Studio.
Klik Multimodal.
Di bagian Contoh perintah, cari perintah berjudul Ekstrak teks dari gambar, lalu klik Buka.
Halaman perintah akan terbuka dan perintah akan diisi di kolom Prompt.
Kirim perintah dengan mengklik Kirim.
Model akan menampilkan respons.
Lihat kode yang setara dengan permintaan perintah ini dengan mengklik
Dapatkan kode.
Langkah selanjutnya
- Pelajari Vertex AI Gemini API lebih lanjut.
- Pelajari cara mendesain perintah multimodal.
- Lihat panduan mendalam tentang Vertex AI Gemini API:
- Lihat referensi Vertex AI Gemini API.
- Lihat referensi Vertex AI Gemini API Python SDK.