Ringkasan Cloud Translation API

Cloud Translation API dapat menerjemahkan teks untuk lebih dari 100 pasangan bahasa. Jika Anda tidak tahu bahasa teks sumber, Cloud Translation API dapat mendeteksinya untuk Anda. Untuk mengetahui daftar semua bahasa yang didukung, lihat Bahasa yang didukung.

Sebagai organisasi perusahaan, Anda dapat menyertakan teks terjemahan dalam alur kerja internal yang ada. Misalnya, Anda mungkin memiliki tim dukungan global yang menerima kasus pelanggan dalam berbagai bahasa. Anda dapat menambahkan Cloud Translation API ke dalam alur kerja Anda untuk menerjemahkan kasus pelanggan tersebut ke dalam bahasa yang digunakan oleh anggota tim dukungan Anda. Dengan Cloud Translation API, Anda meningkatkan efisiensi tim dukungan secara keseluruhan karena mereka tidak perlu menerjemahkan teks secara manual atau mengandalkan orang lain.

Cloud Translation API dapat diskalakan dengan lancar dan memungkinkan terjemahan karakter tanpa batas per hari. Namun, ada batasan ukuran konten untuk tiap permintaan dan rasio permintaan. Selain itu, Anda dapat menggunakan batas kuota untuk mengelola anggaran. Untuk mengetahui informasi selengkapnya, lihat Kuota dan batas.

Edisi dan model Cloud Translation API

Cloud Translation API tersedia dalam dua edisi yang berbeda, yaitu edisi Basic dan edisi Advanced. Untuk mengetahui daftar berbagai fitur yang didukung oleh setiap edisi, lihat perbandingan edisi.

Cloud Translation API memberi Anda pilihan model, sehingga Anda dapat memilih model yang sesuai dengan aplikasi tertentu.

Cloud Translation - Basic API

Edisi Basic dapat diakses melalui library klien v2, dan memerlukan konfigurasi minimal, menerima kunci API untuk autentikasi serta akun layanan. Edisi ini hanya memberikan akses ke model Google terjemahan mesin neural (NMT) yang tidak dimodifikasi. Edisi ini cocok untuk aplikasi yang perlu menerjemahkan konten buatan pengguna kasual seperti chat, media sosial, atau komentar.

Jika Anda merencanakan project baru, sebaiknya pilih edisi Advanced, bukan edisi Basic, untuk memanfaatkan keamanan yang lebih baik, lebih banyak fitur, dan peningkatan layanan baru yang akan terus dilakukan oleh edisi Advanced.

Cloud Translation - Advanced API

Edisi Advanced dapat diakses melalui library klien v3 dan memerlukan autentikasi akun layanan yang terintegrasi dengan peran IAM. Edisi ini menawarkan pilihan model, termasuk model LLM Terjemahan (TLLM) terbaru serta model NMT dengan dan tanpa penyesuaian. Edisi ini juga menawarkan fitur seperti glosarium, terjemahan batch, terjemahan dokumen, dan lainnya:

  • Glosarium: Glosarium adalah kamus kustom yang Anda buat untuk menerjemahkan istilah khusus domain dengan benar dan konsisten.

  • Permintaan batch: Permintaan batch memungkinkan Anda membuat permintaan asinkron yang menerjemahkan teks dalam jumlah besar.

  • Terjemahan Dokumen: Fitur ini memungkinkan Anda menerjemahkan dokumen seperti file PDF sambil mempertahankan format dan tata letak aslinya.

  • Peran IAM: Peran IAM memungkinkan Anda mengamankan permintaan terjemahan melalui Identity and Access Management. Anda dapat membuat akun layanan dan memberikan izin menggunakan peran IAM. Perhatikan bahwa Cloud Translation - Advanced API tidak mendukung kunci API.

  • Label: Anda dapat menambahkan label yang ditentukan pengguna (key-value pair) ke permintaan terjemahan untuk melacak penggunaan dan mengaktifkan laporan penagihan mendetail.

  • Endpoint regional: Dengan menggunakan endpoint regional, Anda dapat mengontrol lokasi penyimpanan dan pemrosesan resource untuk project Anda.

Fitur Advanced API

Menggunakan Cloud Translation - Advanced API, bukan Cloud Translation - Basic API, memberi Anda akses ke fitur berikut yang dapat membuat solusi terjemahan Anda lebih andal dan lebih sesuai dengan kasus penggunaan tertentu:

Pemilihan dan penyesuaian model

Dengan pemilihan model pada Cloud Translation - Advanced API Anda dapat memilih model yang berbeda secara dinamis, termasuk model yang Anda sesuaikan agar sesuai dengan aplikasi tertentu.

Glosarium

Glosarium adalah kamus kustom yang digunakan Cloud Translation - Advanced API untuk menerjemahkan istilah khusus domain, entity bernama, dan jenis istilah lainnya yang spesifik bagi Anda dengan benar dan konsisten. Misalnya, Anda dapat menggunakan glosarium untuk menentukan terjemahan tertentu untuk istilah seperti "Google Summer of Code", "mode rahasia Gmail", atau "laporan performa penempatan".

Anda juga dapat menggunakan glosarium untuk mencegah penerjemahan kata tertentu, seperti kata pinjaman atau nama produk. Untuk mengetahui informasi cara menggunakan glosarium, lihat Membuat dan menggunakan glosarium.

Permintaan batch

Permintaan terjemahan batch adalah permintaan asinkron yang menerjemahkan input dari bucket Cloud Storage. Cloud Translation - Advanced API melakukan terjemahan batch sebagai operasi yang berjalan lama dan menulis output ke bucket Cloud Storage yang Anda tentukan. Permintaan inline untuk terjemahan batch tidak didukung.

Terjemahan Dokumen

Dengan Terjemahan Dokumen, Anda dapat langsung menerjemahkan dokumen yang sudah ada, seperti file PDF dan DOCX, ke bahasa target. Terjemahan Dokumen mempertahankan format aslinya sehingga dokumen yang diterjemahkan memiliki tata letak dan format yang sama dengan dokumen aslinya. Misalnya, Terjemahan Dokumen mempertahankan jeda paragraf dan judul, sehingga konten terjemahan Anda dibagi dengan cara yang sama seperti dalam dokumen asli.

Fitur Cloud Translation - Advanced API, seperti glosarium dan model NMT yang disesuaikan, juga berfungsi untuk Terjemahan Dokumen. Misalnya, jika Anda sudah memiliki model NMT yang disesuaikan dan digunakan untuk terjemahan teks, Anda dapat menggunakan model yang sama untuk Terjemahan Dokumen. Untuk mengetahui informasi selengkapnya tentang jenis file yang didukung dan cara menerjemahkan dokumen, lihat Menerjemahkan dokumen.

Peran IAM

Cloud Translation - Advanced API terintegrasi dengan IAM untuk memberikan keamanan tambahan untuk permintaan terjemahan Anda, memungkinkan kontrol akses yang mendetail, dan mendukung integrasi dengan model NMT kustom.

Anda harus menambahkan pengguna dan akun layanan ke salah satu peran berikut untuk memberi akun tersebut akses ke Cloud Translation - Advanced API. Untuk mengetahui informasi cara membuat akun layanan, lihat Membuat dan mengelola akun layanan dalam dokumentasi IAM.

Peran ID Peran Deskripsi
Viewer Cloud Translation API roles/cloudtranslate.viewer Dapat mengakses operasi get dan list.
Pengguna Cloud Translation API roles/cloudtranslate.user

Mencakup izin roles/cloudtranslate.viewer. Dapat menerjemahkan teks menggunakan model NMT Google dan model NMT kustom dalam mode online dan asinkron (batch). Dapat menggunakan Document Translation. Dapat mendeteksi bahasa. Dapat mencantumkan bahasa yang didukung untuk model NMT model. Dapat menggunakan glosarium untuk terjemahan.
Cloud Translation API Editor roles/cloudtranslate.editor

Mencakup izin roles/cloudtranslate.user, dan dapat membuat serta menghapus glosarium, serta membatalkan atau menghapus operasi yang berjalan lama.
Admin Cloud Translation API roles/cloudtranslate.admin

Mencakup izin roles/cloudtranslate.editor, dapat menetapkan kebijakan IAM dan memberikan izin IAM untuk Cloud Translation API. Memiliki semua izin IAM untuk Cloud Translation API.

Untuk melihat daftar izin yang terdapat dalam setiap peran, baca Memahami peran.

Peran yang telah dikonfigurasi sebelumnya ini dapat menangani banyak kasus penggunaan umum. Namun, Anda mungkin memerlukan peran yang memiliki sekumpulan izin khusus. Misalnya, Anda mungkin ingin membuat peran yang memungkinkan pengguna membuat glosarium dalam project, tanpa mengizinkan mereka untuk menghapus atau memperbarui glosarium yang sudah ada dalam project. Dalam kasus tersebut, Anda dapat membuat peran khusus IAM yang memenuhi kebutuhan Anda.

Untuk informasi cara mengelola peran IAM, baca Memberikan, mengubah, dan mencabut akses ke resource dan Memberikan peran ke akun layanan.

Label

Cloud Translation - Advanced API mendukung penambahan label yang ditentukan pengguna (key-value pair) ke permintaan TranslateText, BatchTranslateText, dan DetectLanguage. Informasi tentang penggunaan permintaan diteruskan ke sistem penagihan, yang dapat Anda gunakan untuk mengelompokkan biaya penagihan dengan memfilter label.

Untuk informasi selengkapnya tentang label yang ditentukan pengguna, baca Melaporkan penggunaan dengan label (Advanced).

Endpoint regional

Secara default, Cloud Translation - Advanced API menyimpan dan memproses resource di lokasi global, yang berarti tidak ada jaminan resource akan tetap berada di dalam lokasi tertentu. Daripada menggunakan endpoint global default, Anda dapat menggunakan endpoint regional untuk menjaga agar resource tetap berada di lokasi tertentu, seperti Uni Eropa. Untuk informasi selengkapnya, baca Menentukan endpoint regional.

Perbandingan edisi

Tabel berikut menunjukkan fitur yang tersedia di tiap edisi.

Fitur Basic Advanced
Menerjemahkan dengan model NMT
Menerjemahkan dengan LLM Terjemahan
Menerjemahkan dengan model Terjemahan Adaptif
Menerjemahkan dengan model kustom
Menerjemahkan beberapa string dalam satu permintaan
Terjemahan dalam batch dengan Cloud Storage
Menerjemahkan dokumen
Dukungan glosarium (kontrol terhadap terminologi)
Melatih model kustom
Deteksi Bahasa
REST API terintegrasi
gRPC API terintegrasi
Akun Layanan
Kunci API
Logging audit
Mendukung HTML
Mendukung Lebih dari 100 Bahasa
Dukungan pengubahan karakter ke dalam aksara Latin
Dukungan transliterasi
Terjemahan Adaptif
Dukungan endpoint multi-regional
Dukungan Kontrol Layanan VPC

Baca Fitur Cloud Translation - Advanced API untuk detail selengkapnya mengenai Cloud Translation - Advanced API.

Harga

Cloud Translation API memberikan tagihan kepada Anda setiap bulan berdasarkan jumlah karakter yang Anda kirim. Untuk mengetahui informasi selengkapnya, lihat Harga.

Referensi dan bacaan lebih lanjut