Halaman ini diterjemahkan oleh Cloud Translation API.

Menyiapkan project terjemahan

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

Anda menyiapkan project terjemahan menggunakan konsol GDC dan gdcloud CLI sebagai berikut:

Konsol GDC: Aktifkan Vertex AI Translation API dan lihat status serta endpoint layanan.
gdcloud CLI: Mengonfigurasi akun layanan untuk berinteraksi dengan Vertex AI Translation API, menginstal library klien, dan mengautentikasi permintaan API.

Membuat project

Membuat project terjemahan dalam hierarki resource Distributed Cloud akan mengatur resource Vertex AI Translation Anda, yang mencakup kolaborator, API yang diaktifkan, alat pemantauan, informasi penagihan, kredensial autentikasi, dan kontrol akses.

Untuk membuat project, lihat Menyiapkan project untuk Vertex AI. Anda memerlukan project ID saat melakukan panggilan API.

Meminta izin developer

Anda harus memiliki peran Developer AI Translation di project Anda untuk mengakses layanan terjemahan dan membuat token API untuk autentikasi dan otorisasi permintaan.

Minta Admin IAM Project Anda untuk memberikan peran AI Translation Developer (ai-translation-developer) kepada akun pengguna atau layanan Anda dalam namespace project Anda. Untuk mengetahui informasi tentang peran ini, lihat Siapkan izin IAM.

Mengaktifkan Vertex AI Translation API

Anda harus mengaktifkan Vertex AI Translation API terlatih sebelumnya untuk project Anda. Jika diaktifkan, Anda dapat melihat status layanan dan endpoint untuk Vertex AI Translation API terlatih sebelumnya.

Menginstal library klien

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

Instal library klien Vertex AI Translation dan ikuti langkah-langkah berikut untuk memastikan Anda memiliki versi yang benar:

Periksa apakah library klien Vertex AI Translation telah diinstal dan dapatkan nomor versinya:
```
pip freeze | grep translation
```
Jika library klien sudah diinstal, Anda akan mendapatkan output yang mirip dengan contoh berikut:
```
google-cloud-translation==3.8.0
```
Nomor versi yang Anda dapatkan harus cocok dengan library klien di endpoint berikut:
```
https://GDC_URL/.well-known/static/client-libraries
```
Ganti GDC_URL dengan URL organisasi Anda di GDC.
Jika nomor versi tidak cocok, hapus instalasi library klien:
```
pip uninstall google-cloud-translation
```
Jika Anda meng-uninstal library klien Vertex AI Translation, Anda harus menginstalnya kembali dengan menentukan nama file yang sesuai dengan sistem operasi Anda.

Menetapkan variabel lingkungan

Setelah menginstal library klien Vertex AI Translation, 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 saat dijalankan.

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

Buat notebook JupyterLab untuk berinteraksi dengan API terlatih sebelumnya Vertex AI Translation.
Buat skrip Python di notebook JupyterLab.
Tambahkan kode berikut ke skrip Python:
```
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.
Simpan skrip Python dengan nama, seperti translation.py.
Jalankan skrip Python untuk menetapkan variabel lingkungan:
```
python SCRIPT_NAME
```
Ganti SCRIPT_NAME dengan nama yang Anda berikan ke skrip Python, seperti translation.py.

Menyiapkan autentikasi

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