Azure Translator di Foundry Tools v3.0

Apa yang baru?

Penerjemah versi 3.0 menyediakan API Web berbasis JSON modern. Ini meningkatkan kegunaan dan performa dengan mengonsolidasikan fitur yang ada menjadi lebih sedikit operasi dan menyediakan fitur baru.

  • Transliterasi untuk mengonversi teks dalam satu bahasa dari satu skrip ke skrip lain.
  • Terjemahan ke beberapa bahasa dalam satu permintaan.
  • Deteksi bahasa, terjemahan, dan transliterasi dalam satu permintaan.
  • Kamus untuk mencari terjemahan alternatif dari suatu istilah, untuk menemukan terjemahan kembali dan contoh yang menunjukkan istilah yang digunakan dalam konteks.
  • Hasil deteksi bahasa yang lebih informatif.

URL Dasar

URL dasar global adalah https://api.cognitive.microsofttranslator.com. Terjemahan teks juga mendukung geografi dan titik akhir khusus sumber daya. Untuk semua URL titik akhir dan lokasi pemrosesan permintaannya, lihat Dukungan wilayah untuk Azure Translator.

dukungan Virtual Network

Penerjemah sekarang tersedia dengan kemampuan Virtual Network (VNET) di semua wilayah cloud publik Azure. Untuk mengaktifkan Virtual Network, See Mengonfigurasi jaringan virtual Foundry Tools.

Setelah mengaktifkan kemampuan ini, Anda harus menggunakan titik akhir kustom untuk memanggil Penerjemah. Anda tidak dapat menggunakan titik akhir penerjemah global ("api.cognitive.microsofttranslator.com") dan Anda tidak dapat mengautentikasi dengan token akses.

Anda dapat menemukan titik akhir kustom setelah membuat sumber daya penerjemah dan mengizinkan akses dari jaringan yang dipilih dan titik akhir privat.

  1. Navigasi ke sumber daya Penerjemah Anda di portal Azure.

  2. Pilih Jaringan dari bagian Manajemen Sumber Daya.

  3. Di bawah tab Firewall dan jaringan virtual, pilih Jaringan yang Dipilih dan Titik Akhir Pribadi.

    Screenshot pengaturan jaringan virtual di portal Azure.

  4. Pilih Simpan untuk menerapkan perubahan Anda.

  5. Pilih Kunci dan Titik Akhir dari bagian Manajemen Sumber Daya .

  6. Pilih tab Virtual Network.

  7. Tercantum ada titik akhir untuk terjemahan Teks dan Terjemahan dokumen.

    Cuplikan layar titik akhir jaringan virtual.

Headers Deskripsi
Ocp-Apim-Subscription-Key Nilainya adalah kunci rahasia Azure untuk langganan Anda ke Penerjemah.
Ocp-Apim-Subscription-Region Nilainya adalah wilayah sumber daya penerjemah. Nilai ini bersifat opsional jika sumber daya global

Berikut adalah contoh permintaan untuk memanggil Penerjemah menggunakan titik akhir kustom

// Pass secret key and region using headers
curl -X POST "https://<your-custom-domain>.cognitiveservices.azure.com/translator/text/v3.0/translate?api-version=3.0&to=es" \
     -H "Ocp-Apim-Subscription-Key:<your-key>" \
     -H "Ocp-Apim-Subscription-Region:<your-region>" \
     -H "Content-Type: application/json" \
     -d "[{'Text':'Hello, what is your name?'}]"

Metrics

Metrik memungkinkan Anda melihat informasi penggunaan dan ketersediaan penerjemah di portal Azure. Untuk informasi selengkapnya, lihat Metrik data dan platform.

Metrik Penerjemah

Tabel ini mencantumkan metrik yang tersedia dengan deskripsi tentang bagaimana metrik tersebut digunakan untuk memantau panggilan API terjemahan.

Metrics Deskripsi
TotalCalls Jumlah total panggilan API.
TotalTokenCalls Jumlah total panggilan API melalui layanan token menggunakan token autentikasi.
SuccessfulCalls Jumlah panggilan yang berhasil.
TotalErrors Jumlah panggilan dengan respons kesalahan.
BlockedCalls Jumlah panggilan yang melebihi batas tarif atau kuota.
ServerErrors Jumlah panggilan dengan kesalahan internal server (5XX).
ClientErrors Jumlah panggilan dengan kesalahan sisi klien (4XX).
Keterlambatan Durasi untuk menyelesaikan permintaan dalam milidetik.
Karakter Diterjemahkan Jumlah total karakter dalam permintaan teks masuk.