Menerjemahkan teks

Layanan Vertex AI Translation memungkinkan Anda menerjemahkan teks yang ditulis dalam satu bahasa ke bahasa lain yang didukung.

Halaman ini menunjukkan cara menerjemahkan teks sampel menggunakan Vertex AI Translation API di perangkat air-gapped Google Distributed Cloud (GDC).

Sebelum memulai

Sebelum dapat mulai menggunakan Vertex AI Translation API, Anda harus memiliki project dengan Vertex AI Translation API yang diaktifkan, dan Anda harus memiliki kredensial yang sesuai. Anda juga dapat menginstal library klien untuk membantu Anda melakukan panggilan ke API. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan project terjemahan.

Menerjemahkan teks

Metode translateText mengambil teks input dalam bahasa tertentu dan menampilkan teks yang diterjemahkan ke dalam bahasa lain. Anda dapat memasukkan teks biasa atau HTML sebagai input.

Jika Anda memasukkan teks HTML, metode translateText hanya menerjemahkan teks di antara tag HTML tanpa menerjemahkan tag. Namun, atribut dalam tag HTML5, seperti atribut alt, diterjemahkan. Contoh penggunaan tag dan atribut HTML5 digunakan dalam sintaksis untuk mengecualikan teks dari terjemahan. Output mempertahankan tag HTML yang tidak diterjemahkan dan menyertakan teks terjemahan di antaranya.

Buat permintaan curl ke Vertex AI Translation API yang telah dilatih sebelumnya. Atau, berinteraksi dengan API terlatih Vertex AI Translation dari skrip Python untuk menerjemahkan teks dari satu bahasa ke bahasa lain.

Contoh berikut menunjukkan cara menerjemahkan teks input dari satu bahasa ke bahasa lain:

curl

Ikuti langkah-langkah berikut untuk membuat permintaan curl:

  1. Dapatkan token autentikasi.

  2. Buat permintaan:

curl -vv -X POST -H "Content-Type: application/json" -H "Authorization: Bearer TOKEN" https://ENDPOINT/v3/projects/PROJECT_ID:translateText -d '{"parent": "projects/PROJECT_ID", "source_language_code": "SOURCE_LANGUAGE", "target_language_code": "TARGET_LANGUAGE", "contents": ["INPUT_TEXT"]}'

Ganti kode berikut:

  • TOKEN: token autentikasi yang Anda peroleh.
  • ENDPOINT: endpoint Vertex AI Translation yang Anda gunakan untuk organisasi Anda. Untuk mengetahui informasi selengkapnya, lihat status dan endpoint layanan.
  • PROJECT_ID: project ID Anda.
  • SOURCE_LANGUAGE: kode bahasa teks input Anda. Lihat daftar bahasa yang didukung dan kode bahasanya masing-masing.
  • TARGET_LANGUAGE: kode bahasa yang Anda inginkan untuk menerjemahkan teks Anda. Lihat daftar bahasa yang didukung dan kode bahasanya masing-masing.
  • INPUT_TEXT: teks input Anda dalam bahasa sumber.

Gunakan kolom mime_type untuk menentukan jenis file. Tetapkan kolom mime_type ke salah satu nilai berikut:

  • text/plain: input Anda adalah teks biasa.
  • text/html: input Anda adalah teks HTML.

Jika kolom mime_type kosong, text/html adalah nilai defaultnya.

Contoh berikut menggunakan kolom mime_type:

curl -vv -X POST -H "Content-Type: application/json" -H "Authorization: Bearer TOKEN" https://ENDPOINT/v3/projects/PROJECT_ID:translateText -d '{"mime_type": "text/html", "parent": "projects/PROJECT_ID", "source_language_code": "SOURCE_LANGUAGE", "target_language_code": "TARGET_LANGUAGE", "contents": ["INPUT_TEXT"]}'

Output menampilkan teks yang diterjemahkan.

Python

Ikuti langkah-langkah berikut untuk menggunakan layanan Vertex AI Translation dari skrip Python:

  1. Instal library klien Vertex AI Translation versi terbaru.

  2. Tetapkan variabel lingkungan yang diperlukan pada skrip Python.

  3. Lakukan autentikasi permintaan API Anda.

  4. Tambahkan kode berikut ke skrip Python yang Anda buat:

    from google.cloud import translate
import google.auth
from google.auth.transport import requests
from google.api_core.client_options import ClientOptions

audience = "https://ENDPOINT:443"
api_endpoint="ENDPOINT:443"

def translate_client(creds):
  opts = ClientOptions(api_endpoint=api_endpoint)
  return translate.TranslationServiceClient(credentials=creds, client_options=opts)

def main():
  creds = None
  try:
    creds, project_id = google.auth.default()
    creds = creds.with_gdch_audience(audience)
    req = requests.Request()
    creds.refresh(req)
    print("Got token: ")
    print(creds.token)
  except Exception as e:
    print("Caught exception" + str(e))
    raise e
  return creds

def translate_func(creds):
  tc = translate_client(creds)
  req = {
    "parent": "projects/PROJECT_ID",
    "source_language_code": "SOURCE_LANGUAGE",
    "target_language_code": "TARGET_LANGUAGE",
    "mime_type": "text/plain",
    "contents": ["INPUT_TEXT"]
  }

  resp = tc.translate_text(req)
  print(resp)

if __name__=="__main__":
  creds = main()
  translate_func(creds)

    Ganti kode berikut:

    • ENDPOINT: endpoint Vertex AI Translation yang Anda gunakan untuk organisasi Anda. Untuk mengetahui informasi selengkapnya, lihat status dan endpoint layanan.
    • PROJECT_ID: project ID Anda.
    • SOURCE_LANGUAGE: kode bahasa teks input Anda. Lihat daftar bahasa yang didukung dan kode bahasanya masing-masing.
    • TARGET_LANGUAGE: kode bahasa yang Anda inginkan untuk menerjemahkan teks Anda. Lihat daftar bahasa yang didukung dan kode bahasanya masing-masing.
    • INPUT_TEXT: teks input Anda dalam bahasa sumber.

    Gunakan kolom mime_type untuk menentukan jenis file. Tetapkan kolom mime_type ke salah satu nilai berikut:

    • text/plain: input Anda adalah teks biasa.
    • text/html: input Anda adalah teks HTML.

    Jika kolom mime_type kosong, text/html adalah nilai defaultnya.

  5. Simpan skrip Python.

  6. Jalankan skrip Python untuk menerjemahkan teks:

    python SCRIPT_NAME

    Ganti SCRIPT_NAME dengan nama yang Anda berikan ke skrip Python, seperti translation.py.

Mengecualikan teks dari terjemahan

Gunakan salah satu tag HTML berikut di kolom contents permintaan untuk mengecualikan bagian teks Anda dari terjemahan:

  • <span translate="no">"TEXT"</span>
  • <span class="notranslate">"TEXT"</span>

Ganti TEXT dengan bagian teks yang ingin Anda kecualikan dari terjemahan.

Misalnya, jika Anda memiliki teks input berikut dalam bahasa Prancis:

Bonjour, c'est un test.

Kemudian, teks tersebut diterjemahkan ke dalam bahasa Inggris menjadi kalimat berikut:

Hello, this is a test.

Misalkan Anda hanya ingin menerjemahkan bagian teks berikut, tidak termasuk Bonjour, dari teks input:

c'est un test.

Bagian teks tersebut diterjemahkan dalam bahasa Inggris menjadi kalimat berikut:

this is a test.

Gunakan tag HTML untuk mengecualikan teks dari terjemahan. Misalnya, permintaan curl berikut menggunakan tag <span class="notranslate">"TEXT"</span> untuk mengecualikan Bonjour, dari teks input sebelumnya dalam bahasa Prancis saat menerjemahkan teks ke dalam bahasa Inggris:

curl -vv -X POST -H "Content-Type: application/json" -H "Authorization: Bearer TOKEN" https://ENDPOINT/v3/projects/PROJECT_ID:translateText -d '{"parent": "projects/PROJECT_ID", "source_language_code": "fr", "target_language_code": "en", "contents": [<span class="notranslate">"Bonjour,"</span>"c'est un test."]}'

Deteksi bahasa

Metode detectLanguage menampilkan bahasa string teks dengan mengirim permintaan HTTP.

Misalnya, permintaan berikut mendeteksi bahasa Inggris sebagai bahasa dari teks input Hello, this is a test:

curl

curl -vv -X POST -H "Content-Type: application/json" -H "Authorization: Bearer TOKEN" https://ENDPOINT/v3/projects/PROJECT_ID:detectLanguage -d '{"parent": "projects/PROJECT_ID", "content": "Hello, this is a test"}'

Mendapatkan bahasa yang didukung

Metode supportedLanguages menampilkan daftar bahasa yang didukung oleh Vertex AI Translation API.

Misalnya, permintaan berikut menampilkan bahasa yang didukung dengan menentukan endpoint Vertex AI Translation:

curl

curl -vv -X POST -H "Content-Type: application/json" -H "Authorization: Bearer TOKEN" https://ENDPOINT/v3/projects/PROJECT_ID/locations/PROJECT_ID/supportedLanguages -d "{}"

Untuk mengetahui daftar lengkap bahasa yang didukung, lihat Bahasa yang didukung untuk Vertex AI Translation.