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 menggunakan 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 berbeda, yaitu edisi Basic dan edisi Advanced. Untuk mengetahui daftar berbagai fitur yang didukung oleh setiap edisi, lihat perbandingan edisi.

Solusi ini memberi Anda pilihan model, sehingga Anda dapat memilih model yang sesuai dengan aplikasi tertentu Anda.

Cloud Translation - Basic API

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

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

Cloud Translation - Advanced API

Edisi Advanced diakses melalui library klien v3 dan memerlukan autentikasi akun layanan yang terintegrasi dengan peran IAM. Layanan ini menawarkan pilihan model, termasuk model LLM Terjemahan (TLLM) terbaru serta model NMT dengan dan tanpa penyesuaian. Layanan 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 dengan 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 terperinci.

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

Fitur API lanjutan

Dengan menggunakan Cloud Translation - Advanced API, bukan Cloud Translation - Basic API, Anda akan mendapatkan akses ke fitur berikut yang dapat membuat solusi terjemahan Anda lebih andal dan lebih sesuai dengan kasus penggunaan spesifik Anda:

Pemilihan dan penyesuaian model

Pemilihan model Cloud Translation - Advanced API memungkinkan Anda memilih model yang berbeda secara dinamis, termasuk model yang Anda sesuaikan agar sesuai dengan aplikasi tertentu Anda.

Glosarium

Glosarium adalah kamus kustom yang digunakan Cloud Translation - Advanced API untuk menerjemahkan istilah spesifik domain, entity bernama, dan jenis istilah lainnya yang spesifik bagi Anda dengan benar dan konsisten. Misalnya, Anda dapat menggunakan glosarium untuk menentukan terjemahan istilah tertentu, 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 tentang 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 yang digunakan untuk terjemahan teks, Anda dapat menggunakan model yang sama untuk Terjemahan Dokumen. Untuk informasi selengkapnya tentang jenis file yang didukung dan cara menerjemahkan dokumen, baca 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 informasi cara membuat akun layanan, baca 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. 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 dalam 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 mengetahui detail selengkapnya tentang Cloud Translation - Advanced API.

Harga

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

Referensi dan bacaan lebih lanjut