Bagikan melalui

Kontainer: Menerjemahkan Dokumen (pratinjau)

  • Artikel

Penting

  • Azure AI Penerjemah rilis pratinjau publik menyediakan akses awal ke fitur yang sedang dalam pengembangan aktif.
  • Fitur, pendekatan, dan proses dapat berubah, sebelum Ketersediaan Umum (GA), berdasarkan umpan balik pengguna.

Terjemahkan dokumen dengan bahasa sumber yang ditentukan.

URL Permintaan (menggunakan cURL)

POST Permintaan:

    POST "http://localhost:{port}/translator/document:translate?sourceLanguage={sourceLanguage}&targetLanguage={targetLanguage}&api-version={api-version}" -F "document=@{path-to-your-document-with-file-extension};type={ContentType}/{file-extension}" -o "{path-to-output-file-with-file-extension}"

Contoh:

curl -i -X POST "http://localhost:5000/translator/document:translate?sourceLanguage=en&targetLanguage=hi&api-version=2023-11-01-preview" -F "document=@C:\Test\test-file.md;type=text/markdown" -o "C:\translation\translated-file.md"

Header dan parameter permintaan sinkron

Gunakan pemrosesan terjemahan sinkron untuk mengirim dokumen sebagai bagian dari isi permintaan HTTP dan menerima dokumen yang diterjemahkan dalam respons HTTP.

Parameter kueri Deskripsi Kondisi
-X atau --requestPOST Bendera -X menentukan metode permintaan untuk mengakses API. Diperlukan
{endpoint} URL untuk titik akhir sumber daya Terjemahan Dokumen Anda Diperlukan
targetLanguage Menentukan bahasa dokumen output. Bahasa target harus menjadi salah satu bahasa yang didukung yang disertakan dalam cakupan terjemahan. Diperlukan
sourceLanguage Menentukan bahasa dokumen input. Jika parameter sourceLanguage tidak ditentukan, deteksi bahasa otomatis diterapkan untuk menentukan bahasa sumber. Opsional
-H atau --header"Ocp-Apim-Subscription-Key:{KEY} Header permintaan yang menentukan kunci sumber daya Terjemahan Dokumen yang mengotorisasi akses ke API. Diperlukan
-F atau --form Jalur file ke dokumen yang ingin Anda sertakan dengan permintaan Anda. Hanya satu dokumen sumber yang diizinkan. Diperlukan
• document=
• type={contentType}/fileExtension		 • Jalur ke lokasi file untuk dokumen sumber Anda.
• Jenis konten dan ekstensi file.

Contoh: "document=@C:\Test\test-file.md; type=text/markdown"		 Diperlukan
-o atau --output Jalur file ke hasil respons. Diperlukan
-F atau --form Jalur file ke glosarium opsional untuk disertakan dengan permintaan Anda. Glosarium memerlukan bendera terpisah --form . Opsional
• glossary=
• type={contentType}/fileExtension		 • Jalur ke lokasi file untuk file glosarium opsional Anda.
• Jenis konten dan ekstensi file.

Contoh: "glosarium=@C:\Test\glossary-file.txt; type=text/plain		 Opsional

✔️ Untuk informasi selengkapnya tentang contentType, lihatFormat dokumen yang didukung.

Sampel kode: terjemahan dokumen

Catatan

  • Setiap sampel berjalan pada localhost yang Anda tentukan dengan docker compose up perintah .
  • Saat kontainer Anda berjalan, localhost arahkan ke kontainer itu sendiri.
  • Anda tidak perlu menggunakan localhost:5000. Anda dapat menggunakan port apa pun yang belum digunakan di lingkungan host Anda.

Sampel dokumen

Untuk proyek ini, Anda memerlukan dokumen sumber untuk diterjemahkan. Anda dapat mengunduh dokumen sampel terjemahan dokumen kami untuk dan menyimpannya di folder yang sama dengan file Anda compose.yaml (container-environment). Nama file adalah document-translation-sample.docx dan bahasa sumbernya adalah bahasa Inggris.

Mengkueri titik akhir azure AI Penerjemah (dokumen)

Berikut adalah contoh permintaan HTTP cURL menggunakan localhost:5000:

curl -v "http://localhost:5000/translator/document:translate?sourceLanguage=en&targetLanguage=es&api-version=2023-11-01-preview" -F "document=@document-translation-sample-docx" -o "C:\translation\translated-file.md"

Setelah berhasil diselesaikan:

  • Dokumen yang diterjemahkan dikembalikan dengan respons.
  • Metode POST yang berhasil mengembalikan kode respons yang 200 OK menunjukkan bahwa layanan membuat permintaan.

Langkah berikutnya

Pelajari selengkapnya tentang terjemahan dokumen sinkron