Membuat sumber daya Penerjemah

Dalam artikel ini, Anda mempelajari cara membuat sumber daya Penerjemah di portal Azure. Azure AI Penerjemah adalah layanan terjemahan mesin berbasis cloud yang merupakan bagian dari keluarga layanan Azure AI. Sumber daya Azure merupakan instans layanan yang Anda buat. Semua permintaan API ke layanan Azure AI memerlukan URL titik akhir dan kunci baca-saja untuk mengautentikasi akses.

Prasyarat

Untuk memulai, Anda memerlukan akun Azure aktif. Jika Anda tidak memilikinya, Anda dapat membuat langganan 12 bulan gratis.

Membuat sumber daya Anda

Dengan akun Azure, Anda dapat mengakses layanan Penerjemah melalui dua jenis sumber daya yang berbeda:

  1. Jenis sumber dayaLayanan tunggal memungkinkan akses ke kunci API layanan tunggal dan titik akhir. Terjemahan Dokumen hanya didukung dalam jenis sumber daya layanan tunggal.

  2. Jenis sumber daya multi-layanan memungkinkan akses ke beberapa layanan Azure AI dengan menggunakan satu kunci API dan titik akhir. Terjemahan Dokumen tidak didukung dalam jenis sumber daya multi-layanan.

Melengkapi detail proyek dan instans Anda

Setelah memutuskan jenis sumber daya mana yang ingin Anda gunakan untuk mengakses layanan Penerjemah, Anda dapat memasukkan detail untuk proyek dan instans Anda.

  1. Langganan. Pilih salah satu langganan Azure Anda yang tersedia.

  2. Grup Sumber Daya. Anda dapat membuat grup sumber daya baru atau menambahkan sumber daya Anda ke grup sumber daya yang sudah ada sebelumnya, yang memiliki siklus hidup, izin, dan kebijakan yang sama.

  3. Wilayah Sumber Daya. Pilih Global kecuali bisnis atau aplikasi Anda memerlukan wilayah tertentu. Jika Anda berencana menggunakan fitur Terjemahan Dokumen dengan otorisasi identitas terkelola, pilih wilayah geografis seperti US Timur.

  4. Nama. Masukkan nama untuk sumber daya baru Anda. Nama yang Anda pilih harus unik dalam Azure.

    Catatan

    Jika Anda menggunakan fitur Penerjemah yang memerlukan titik akhir domain kustom, seperti Terjemahan Dokumen, nilai yang Anda masukkan di bidang Nama akan menjadi parameter nama domain kustom untuk titik akhir.

  5. Tingkat harga. Pilih tingkat harga yang memenuhi kebutuhan Anda:

    • Setiap langganan memiliki tingkat gratis.
    • Tingkat gratis memiliki fitur dan fungsi yang sama dengan paket berbayar dan tidak kedaluwarsa.
    • Hanya satu sumber daya tingkat gratis yang tersedia per langganan.
    • Terjemahan Dokumen hanya didukung dalam tingkat berbayar. Language Studio hanya mendukung tingkat instans S1 atau D3. Jika Anda hanya ingin mencoba Terjemahan Dokumen, pilih tingkat instans S1 Standar.
  6. Jika Anda membuat sumber daya multi-layanan, tautan di bagian bawah tab Dasar menyediakan dokumentasi teknis mengenai operasi layanan yang sesuai.

  7. Pilih Tinjau + Buat.

  8. Tinjau ketentuan layanan, dan pilih Buat untuk menyebarkan sumber daya Anda.

  9. Setelah sumber daya Anda berhasil disebarkan, pilih Buka sumber daya.

    Kunci autentikasi dan URL titik akhir

    Semua permintaan API layanan Azure AI memerlukan URL titik akhir dan kunci baca-saja untuk autentikasi.

    • Kunci autentikasi. Kunci Anda adalah string unik yang diteruskan di setiap permintaan ke layanan Penerjemahan. Anda dapat meneruskan kunci melalui parameter string kueri atau dengan menentukannya di header permintaan HTTP.

    • URL Titik Akhir. Gunakan titik akhir Global dalam permintaan API Anda kecuali jika Anda memerlukan wilayah Azure atau titik akhir kustom tertentu. Untuk informasi selengkapnya, lihat URL Dasar. URL titik akhir Global adalah api.cognitive.microsofttranslator.com.

Mendapatkan kunci autentikasi dan titik akhir Anda

Untuk mengautentikasi koneksi ke sumber daya Penerjemah, Anda perlu menemukan kunci dan titik akhirnya.

  1. Setelah sumber daya baru Anda disebarkan, pilih Buka sumber daya atau buka halaman sumber daya Anda.

  2. Di panel navigasi kiri, di bawah Manajemen Sumber Daya, pilih Kunci dan Titik Akhir.

  3. Salin dan tempel kunci dan URL titik akhir Anda di lokasi yang nyaman, seperti Notepad.

    Cuplikan layar portal Azure memperlihatkan halaman Kunci dan Titik Akhir sumber daya Penerjemah. Kunci dan titik akhir disorot.

Membuat klien Terjemahan Teks

Terjemahan Teks mendukung titik akhir global dan regional. Setelah Anda memiliki kunci autentikasi, Anda perlu membuat instansTextTranslationClient , menggunakan untuk autentikasiAzureKeyCredential, untuk berinteraksi dengan layanan Terjemahan Teks:

  1. Untuk membuat TextTranslationClient menggunakan titik akhir sumber daya global, Anda memerlukan kunci API sumber daya Anda:

      AzureKeyCredential credential = new('<apiKey>');
      TextTranslationClient client = new(credential);
    
  2. Untuk membuat TextTranslationClient menggunakan titik akhir sumber daya regional, Anda memerlukan kunci API sumber daya dan nama wilayah tempat sumber daya Anda berada:

    AzureKeyCredential credential = new('<apiKey>');
    TextTranslationClient client = new(credential, '<region>');
    

Membuat klien Terjemahan Dokumen

Gunakan API Terjemahan Dokumen untuk menerjemahkan teks dalam volume besar secara asinkron dan beberapa dokumen di seluruh bahasa. Proses terjemahan batch memerlukan akun penyimpanan Azure Blob dengan kontainer penyimpanan untuk sumber dan dokumen yang diterjemahkan.

  1. Terjemahan Dokumen saat ini didukung di sumber daya Penerjemah (layanan tunggal) menggunakan Paket Layanan Standar S1 (Bayar sesuai penggunaan) atau dalam Paket Diskon Volume D3.

  2. "Untuk informasi selengkapnya tentang membuat sumber daya Penerjemah untuk Terjemahan Dokumen, lihat Prasyarat: Menggunakan Terjemahan Dokumen".

Cara menghapus grup sumber daya atau sumber daya

Peringatan

Menghapus grup sumber daya juga akan menghapus sumber daya lain yang berada dalam grup tersebut.

Untuk menghapus sumber daya:

  1. Cari dan pilih Grup sumber daya di portal Azure, dan pilih grup sumber daya Anda.

  2. Pilih sumber daya yang akan dihapus dengan memilih kotak centang yang berdekatan.

  3. Pilih Hapus dari menu atas di dekat tepi kanan.

  4. Masukkan hapus dalam kotak dialog Hapus Sumber Daya .

  5. Pilih Hapus.

Untuk menghapus grup sumber daya:

  1. Buka Grup Sumber Daya Anda di portal Azure.

  2. Pilih Hapus grup sumber daya dari bilah menu atas.

  3. Konfirmasi permintaan penghapusan dengan memasukkan nama grup sumber daya dan memilih Hapus.

Langkah selanjutnya