Cloud Translation - Advanced dioptimalkan untuk penyesuaian dan kasus penggunaan konten panjang. Selain model Terjemahan Mesin Neural (NMT), Advanced memberi Anda akses ke LLM Terjemahan (model terjemahan gaya LLM dengan kualitas tertinggi terbaru dari Google) dan kemampuan untuk membuat model kustom.
Cloud Translation - Advanced juga menyediakan kemampuan terjemahan teks lanjutan seperti menerjemahkan dokumen dan membuat glosarium untuk memastikan bahwa terminologi khusus domain Anda diterjemahkan dengan benar.
Sebelum memulai
Sebelum dapat mulai menggunakan Cloud Translation API, Anda harus memiliki project yang mengaktifkan Cloud Translation API, dan harus memiliki kredensial yang sesuai. Anda juga dapat menginstal library klien untuk bahasa pemrograman umum guna membantu melakukan panggilan ke API. Untuk informasi selengkapnya, lihat halaman Penyiapan.
Untuk mengetahui petunjuk cara menginstal Google Cloud CLI, menyiapkan project dengan akun layanan, serta mendapatkan token akses, silakan melihat halaman Penyiapan. Jika berencana menggunakan glosarium atau fitur batch, Anda juga harus membuat bucket Cloud Storage dan memberi akun layanan akses ke bucket tersebut.
Menerjemahkan teks
Untuk terjemahan, input dapat berupa teks biasa atau HTML. Cloud Translation API tidak menerjemahkan tag HTML apa pun dalam input, dan hanya menerjemahkan teks yang muncul di antara tag. Output-nya mempertahankan tag HTML (tidak diterjemahkan), dengan teks terjemahan di antara tag selama memungkinkan karena perbedaan antara bahasa sumber dan target.
Menerjemahkan string input
REST
Untuk menerjemahkan teks, buat permintaan POST
dan berikan JSON dalam isi permintaan, yang mengidentifikasi bahasa sumber (source_language_code
), target bahasa (target_language_code
), dan teks yang akan diterjemahkan
(contents
). Anda dapat menyediakan beberapa string teks untuk diterjemahkan dengan menyertakannya dalam JSON (lihat contoh). Anda dapat mengidentifikasi bahasa sumber dan target
menggunakan kode ISO-639-nya.
Berikut ini contoh permintaan POST
yang menggunakan
curl
atau PowerShell. Contoh ini menggunakan token akses untuk akun layanan yang disiapkan untuk project menggunakan Google Cloud
Google Cloud CLI.
Untuk mengetahui petunjuk cara menginstal Google Cloud CLI, menyiapkan project dengan akun layanan, serta mendapatkan token akses, silakan melihat halaman Penyiapan.
Sebelum menggunakan data permintaan apa pun, ganti nilai berikut ini:
- PROJECT_NUMBER_OR_ID: ID numerik atau alfanumerik untuk project Google Cloud Anda
Metode HTTP dan URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText
Meminta isi JSON:
{ "sourceLanguageCode": "en", "targetLanguageCode": "ru", "contents": ["Dr. Watson, come here!", "Bring me some coffee!"] }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON yang mirip dengan berikut ini:
{ "translations": [ { "translatedText": "Доктор Ватсон, иди сюда!", }, { "translatedText": "Принеси мне кофе!", } ] }
Array translations
berisi dua kolom translatedText
dengan terjemahan
yang disediakan dalam bahasa targetLanguageCode
yang diminta (ru
: Rusia). Terjemahan dicantumkan dalam urutan yang sama dengan array sumber yang sesuai dalam permintaan.
Go
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go di panduan memulai Cloud Translation menggunakan library klien. Untuk mengetahui informasi selengkapnya, silakan melihat dokumentasi referensi API Go Cloud Translation.
Untuk melakukan autentikasi ke Cloud Translation, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di panduan memulai Cloud Translation menggunakan library klien. Untuk mengetahui informasi selengkapnya, silakan melihat dokumentasi referensi API Java Cloud Translation.
Untuk melakukan autentikasi ke Cloud Translation, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js di panduan memulai Cloud Translation menggunakan library klien. Untuk mengetahui informasi selengkapnya, silakan melihat dokumentasi referensi API Node.js Cloud Translation.
Untuk melakukan autentikasi ke Cloud Translation, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python di panduan memulai Cloud Translation menggunakan library klien. Untuk mengetahui informasi selengkapnya, silakan melihat dokumentasi referensi API Python Cloud Translation.
Untuk melakukan autentikasi ke Cloud Translation, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Bahasa tambahan
C#: Ikuti Petunjuk penyiapan C# di halaman library klien, lalu buka Dokumentasi referensi Cloud Translation untuk .NET.
PHP: Ikuti Petunjuk penyiapan PHP di halaman library klien, lalu buka Dokumentasi referensi Cloud Translation untuk PHP.
Ruby: Ikuti Petunjuk penyiapan Ruby di halaman library klien, lalu buka Dokumentasi referensi Cloud Translation untuk Ruby.
Menerjemahkan teks menggunakan model tertentu
REST
Anda dapat menentukan model mana yang akan digunakan untuk terjemahan menggunakan parameter kueri
model
.
Contoh berikut menerjemahkan teks menggunakan model kustom dengan ID model
1395675701985363739
. Anda bisa mendapatkan ID model untuk model kustom dari daftar model di konsol Google Cloud atau dari respons API atau halaman pantheon yang sesuai saat melatih model. Untuk menggunakan LLM
terjemahan, tentukan general/translation-llm
sebagai ID model. Untuk menggunakan LLM Translation kustom (Pratinjau Publik), tentukan model/translation-llm-custom/{model-id}
sebagai ID model.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: Google Cloud Project ID Anda.
- LOCATION: Region tempat model kustom berada, seperti
us-central1
.
Metode HTTP dan URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText
Isi JSON permintaan:
{ "model": "projects/PROJECT_ID/locations/LOCATION/models/1395675701985363739", "sourceLanguageCode": "en", "targetLanguageCode": "ru", "contents": ["Dr. Watson, please discard your trash. You've shared unsolicited email with me. Let's talk about spam and importance ranking in a confidential mode."] }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Simpan isi permintaan dalam file bernama request.json
,
dan jalankan perintah berikut:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: PROJECT_ID" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText"
PowerShell
Simpan isi permintaan dalam file bernama request.json
,
dan jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText" | Select-Object -Expand Content
Anda akan melihat respons JSON yang mirip dengan berikut ini:
{ "translation": { "translatedText": "Доктор Ватсон, пожалуйста, откажитесь от своего мусора. Вы поделились нежелательной электронной почтой со мной. Давайте поговорим о спаме и важности рейтинга в конфиденциальном режиме.", "model": "projects/PROJECT_NUMBER/locations/LOCATION/models/1395675701985363739" } }
Go
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go di panduan memulai Cloud Translation menggunakan library klien. Untuk mengetahui informasi selengkapnya, silakan melihat dokumentasi referensi API Go Cloud Translation.
Untuk melakukan autentikasi ke Cloud Translation, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di panduan memulai Cloud Translation menggunakan library klien. Untuk mengetahui informasi selengkapnya, silakan melihat dokumentasi referensi API Java Cloud Translation.
Untuk melakukan autentikasi ke Cloud Translation, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js di panduan memulai Cloud Translation menggunakan library klien. Untuk mengetahui informasi selengkapnya, silakan melihat dokumentasi referensi API Node.js Cloud Translation.
Untuk melakukan autentikasi ke Cloud Translation, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python di panduan memulai Cloud Translation menggunakan library klien. Untuk mengetahui informasi selengkapnya, silakan melihat dokumentasi referensi API Python Cloud Translation.
Untuk melakukan autentikasi ke Cloud Translation, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Bahasa tambahan
C#: Ikuti Petunjuk penyiapan C# di halaman library klien, lalu buka Dokumentasi referensi Cloud Translation untuk .NET.
PHP: Ikuti Petunjuk penyiapan PHP di halaman library klien, lalu buka Dokumentasi referensi Cloud Translation untuk PHP.
Ruby: Ikuti Petunjuk penyiapan Ruby di halaman library klien, lalu buka Dokumentasi referensi Cloud Translation untuk Ruby.
Transliterasi
Transliterasi adalah setelan konfigurasi dalam metode translateText
. Jika
mengaktifkan transliterasi, Anda akan menerjemahkan teks yang diubah ke dalam aksara Romawi (skrip Latin) langsung
ke target bahasa. Misalnya, Anda dapat menerjemahkan teks bahasa Jepang yang diubah ke dalam aksara Latin
langsung ke bahasa Inggris, Spanyol, atau China. Terjemahan yang dihasilkan berada dalam
sistem penulisan target bahasa.
Dalam permintaan transliterasi Anda, hanya sertakan teks yang diubah ke dalam aksara Latin. Jika Anda menggabungkan teks yang diubah ke dalam aksara Latin dengan teks yang tidak diubah ke dalam aksara Latin, Cloud Translation tidak dapat memastikan terjemahan yang konsisten dan tepat.
Pertimbangan
Perbedaan antara transliterasi dengan terjemahan teks standar terletak dalam hal berikut ini:
- Transliterasi mendukung bahasa dalam jumlah yang terbatas. Untuk informasi selengkapnya, silakan melihat kolom Transliterasi di halaman Bahasa yang didukung.
- Jenis MIME harus
text/plain
. HTML tidak didukung. - Transliterasi didukung oleh model standar default saja. Model kustom tidak didukung.
- Transliterasi memiliki kuota konten default yang lebih rendah. Untuk mengetahui informasi selengkapnya, silakan melihat Kuota dan batas.
REST
Tetapkan kolom transliteration_config
pada metode translateText
.
Sebelum menggunakan data permintaan apa pun, ganti nilai berikut ini:
- PROJECT_NUMBER_OR_ID: ID numerik atau alfanumerik untuk project Google Cloud Anda.
- LOCATION: Region tempat Anda ingin menjalankan operasi ini. Contoh,
us-central1
. - SOURCE_LANGUAGE: (Opsional) Kode bahasa teks input. Jika diketahui, tetapkan ke salah satu kode bahasa yang tercantum di Dukungan bahasa.
- TARGET_LANGUAGE: Target bahasa untuk menerjemahkan teks input. Tetapkan ke salah satu kode bahasa yang tercantum di Dukungan bahasa.
- SOURCE_TEXT: Teks yang diubah ke dalam aksara Latin di bahasa sumber yang akan diterjemahkan.
Metode HTTP dan URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText
Meminta isi JSON:
{ "source_language_code": "SOURCE_LANGUAGE", "target_language_code": "TARGET_LANGUAGE", "contents": "SOURCE_TEXT", "mime_type": "text/plain", "transliteration_config": { "enable_transliteration": true} }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON yang mirip dengan berikut ini:
{ "translations": [ { "translatedText": "TRANSLATED_TEXT", } ] }
Referensi tambahan
- Untuk mendapatkan bantuan terkait cara menyelesaikan masalah atau error umum, silakan melihat halaman Pemecahan masalah.