Halaman ini memberikan ringkasan tentang penggunaan API yang diinstal dengan Vertex AI di perangkat air gap Google Distributed Cloud (GDC) dan dokumentasi referensinya.
Endpoint layanan dan dokumen penemuan
Endpoint layanan diperlukan untuk berinteraksi secara terprogram dengan Vertex AI API.
Untuk mendapatkan endpoint API terlatih, lihat status dan endpoint layanan.
Akses API
Anda dapat mengakses API terlatih menggunakan gRPC atau salah satu library klien yang disediakan. Library klien dibangun berdasarkan gRPC.
Atau, Anda dapat mengakses beberapa API terlatih menggunakan REST.
Library klien
Vertex AI menyediakan library klien Python untuk API terlatih. Tabel berikut menunjukkan perbandingan kelebihan dan kekurangan penggunaan library klien:
| Kelebihan | Kekurangan |
|---|---|
|
Dikelola oleh Google.
Autentikasi bawaan. Coba lagi bawaan. Isi permintaan HTTP buffer protokol yang efisien. |
Tidak tersedia untuk semua bahasa pemrograman. |
REST
OCR API dan Translation API mendukung REST. Untuk informasi selengkapnya, lihat referensi REST API untuk layanan ini:
Tabel berikut menunjukkan perbandingan kelebihan dan kekurangan penggunaan REST:
| Kelebihan | Kekurangan |
|---|---|
|
Antarmuka JSON sederhana.
Didukung dengan baik oleh banyak alat dan library Google dan pihak ketiga. |
Anda harus membuat klien Anda sendiri.
Anda harus menerapkan autentikasi. Anda harus menerapkan percobaan ulang. Isi permintaan HTTP JSON yang kurang efisien. Streaming REST tidak didukung oleh API ini. |
Saat memanggil REST API, perilaku nilai default untuk buffer protokol dapat menyebabkan kolom tidak ada dalam respons JSON. Kolom ini ditetapkan ke nilai default, sehingga tidak disertakan dalam respons.
gRPC
API terlatih dan Gemini API mendukung gRPC. Untuk mengetahui informasi selengkapnya tentang deskripsi generik jenis, metode, dan kolom yang dihasilkan untuk library gRPC, lihat referensi gRPC berikut:
Tabel berikut menunjukkan perbandingan kelebihan dan kekurangan penggunaan gRPC:
| Kelebihan | Kekurangan |
|---|---|
|
Mendukung banyak bahasa pemrograman.
Isi permintaan HTTP buffer protokol yang efisien. |
Anda harus membuat klien Anda sendiri dari buffer protokol yang disediakan Google.
Anda harus menerapkan autentikasi. Anda harus menerapkan percobaan ulang. |
Nama jenis, metode, dan kolom
Bergantung pada apakah Anda menggunakan library klien, REST, gRPC, atau KRM, jenis, metode, dan nama kolom untuk API bervariasi dengan cara berikut:
- REST diatur berdasarkan hierarki resource dan metodenya.
- Library klien dan gRPC disusun berdasarkan layanan dan metodenya.
- Nama kolom KRM menggunakan camelCase, tetapi layanan API menerima camelCase atau snake_case.
- Nama kolom REST dan gRPC menggunakan snake_case.
- Nama kolom library klien menggunakan title case, camelCase, atau snake_case, bergantung pada nama yang idiomatis untuk bahasa tersebut.