Mulai Cepat: Penerjemah Azure Cognitive Services

Dalam mulai cepat ini, Anda akan mulai menggunakan layanan Penerjemah untuk menerjemahkan teks dengan bahasa pemrogram pilihan Anda dan REST API.

Catatan

  • Guna memulai dengan cepat, Anda disarankan untuk menggunakan sumber daya global layanan tunggal teks Penerjemah.
  • Dengan sumber daya global layanan tunggal, Anda akan menyertakan satu header otorisasi (Ocp-Apim-Subscription-key) dengan permintaan REST API. Nilai untuk Ocp-Apim-Subscription-key adalah kunci rahasia Azure untuk langganan Teks Penerjemah Anda.
  • Jika Anda memilih untuk menggunakan Cognitive Services multi layanan atau sumber daya Penerjemah regional, dua header autentikasi akan diperlukan: (Ocp-Api-Subscription-Key dan Ocp-Apim-Subscription-Region). Nilai untuk Ocp-Apim-Subscription-Region adalah wilayah yang terkait dengan langganan Anda.
  • Untuk informasi selengkapnya tentang cara menggunakan header Ocp-Apim-Subscription-Region, lihatheader REST API Penerjemah Teks.

Prasyarat

Untuk memulai, Anda akan memerlukan langganan Azure aktif. Jika tidak memiliki langganan Azure, Anda dapat membuat langganan Azure secara gratis

  • Setelah Anda memiliki langganan Azure, buat sumber daya Penerjemah di portal Azure.

  • Setelah sumber daya Anda disebarkan, pilih Buka sumber daya dan ambil kunci dan titik akhir Anda.

    • Anda memerlukan kunci dan titik akhir dari sumber daya untuk menyambungkan aplikasi Anda ke layanan Penerjemah. Anda akan menempelkan kunci dan titik akhir Anda ke dalam kode di mulai cepat nanti. Anda dapat menemukan nilai ini di halaman Kunci dan Titik Akhir portal Microsoft Azure:

      Cuplikan layar: Halaman kunci dan titik akhir portal Microsoft Azure.

  • Gunakan tingkat harga gratis (F0) untuk mencoba layanan dan tingkatkan nanti ke tingkat berbayar untuk produksi.

Header

Untuk memanggil layanan Penerjemah melalui REST API, Anda perlu menyertakan header berikut dengan setiap permintaan. Jangan khawatir, kami akan menyertakan header untuk Anda dalam kode sampel untuk setiap bahasa pemrogram.

Untuk informasi selengkapnya tentang opsi autentikasi Penerjemah, lihat panduanreferensi Penerjemah v3.

Header Nilai Kondisi
Ocp-Apim-Subscription-Key Kunci layanan Penerjemah Anda dari portal Azure. Diperlukan
Ocp-Apim-Subscription-Region Wilayah tempat sumber daya Anda dibuat. Diperlukan saat menggunakan Cognitive Services multi layanan atau sumber daya regional (non-global).
Opsional saat menggunakan Sumber Daya Penerjemah global layanan tunggal.
Tipe-Konten Jenis konten payload. Nilai yang diterima adalah application/json atau charset=UTF-8. Diperlukan
Panjang-Konten Panjang isi permintaan. Opsional

Penting

Ingatlah untuk menghapus kunci dari kode Anda setelah selesai, dan jangan pernah memposting kode secara publik. Untuk produksi, gunakan cara aman menyimpan dan mengakses informasi masuk Anda seperti Azure Key Vault. Untuk informasi selengkapnya, lihat artikel keamanan Cognitive Services.

Terjemahkan teks

Operasi inti layanan Penerjemah adalah menerjemahkan teks. Dalam mulai cepat ini, Anda akan membangun permintaan menggunakan bahasa pemrogram pilihan yang mengambil sumber tunggal (from) dan menyediakan dua output (to). Kemudian kita akan meninjau beberapa parameter yang dapat digunakan untuk menyesuaikan permintaan dan respons.

Menyiapkan proyek Visual Studio Anda

  1. Pastikan Anda memiliki versi IDE Visual Studio saat ini.

    Tip

    Jika Anda baru mengenal Visual Studio, coba modul Learn Pengantar untuk Visual Studio.

  2. Buka Visual Studio.

  3. Dari halaman Mulai, pilih Buat proyek baru.

    Cuplikan layar: Jendela mulai Visual Studio.

  4. Pada halaman Buat proyek baru, masukkan konsol di kotak pencarian. Pilih templat Aplikasi Konsol, lalu pilih Berikutnya.

    Cuplikan layar: Halaman membuat proyek baru di Visual Studio.

  5. Di jendela dialog Konfigurasikan proyek baru Anda, masukkan translator_quickstart di kotak Nama proyek. Biarkan kotak centang "Tempatkan solusi dan proyek di direktori yang sama" tidak dicentang dan pilih Berikutnya.

    Cuplikan layar: Jendela mengonfigurasi dialog proyek baru di Visual Studio.

  6. Di jendela dialog Informasi tambahan, pastikan .NET 6.0 (Dukungan jangka panjang) dipilih. Biarkan kotak centang "Jangan gunakan pernyataan tingkat atas" tidak dicentang dan pilih Buat.

    Cuplikan layar: Jendela dialog informasi tambahan Visual Studio.

Menginstal paket Newtonsoft.json dengan NuGet

  1. Klik kanan pada proyek translator_quickstart Anda dan pilih Kelola Paket NuGet... .

    Cuplikan layar kotak pencarian paket NuGet.

  2. Pilih tab Telusur dan ketik Newtonsoft.json.

    Cuplikan layar jendela penginstalan paket NuGet.

  3. Pilih instal dari jendela manajer paket yang tepat untuk menambahkan paket ke proyek Anda.

    Cuplikan layar tombol penginstalan paket NuGet.

Menjalankan aplikasi C# Anda

Catatan

  • Dimulai dengan .NET 6, proyek baru yang menggunakan templat console menghasilkan gaya program baru yang berbeda dari versi sebelumnya.
  • Output baru menggunakan fitur C# terbaru yang menyederhanakan kode yang perlu Anda tulis.
  • Saat Anda menggunakan versi yang lebih baru, Anda hanya perlu menulis isi metode Main. Anda tidak perlu menyertakan pernyataan tingkat atas, global menggunakan direktif, atau implisit menggunakan direktif.
  • Untuk informasi selengkapnya, lihattemplat C# Baru menghasilkan pernyataan tingkat atas.
  1. Buka file Program.cs.

  2. Hapus kode yang sudah ada sebelumnya, termasuk baris Console.Writeline("Hello World!"). Salin dan tempel sampel kode ke file Program.cs aplikasi Anda. Pastikan Anda memperbarui variabel kunci dengan nilai dari instans Penerjemah portal Azure:

using System.Text;
using Newtonsoft.Json;

class Program
{
    private static readonly string key = "<your-translator-key>";
    private static readonly string endpoint = "https://api.cognitive.microsofttranslator.com";

    // location, also known as region.
    // required if you're using a multi-service or regional (not global) resource. It can be found in the Azure portal on the Keys and Endpoint page.
    private static readonly string location = "<YOUR-RESOURCE-LOCATION>";

    static async Task Main(string[] args)
    {
        // Input and output languages are defined as parameters.
        string route = "/translate?api-version=3.0&from=en&to=fr&to=zu";
        string textToTranslate = "I would really like to drive your car around the block a few times!";
        object[] body = new object[] { new { Text = textToTranslate } };
        var requestBody = JsonConvert.SerializeObject(body);

        using (var client = new HttpClient())
        using (var request = new HttpRequestMessage())
        {
            // Build the request.
            request.Method = HttpMethod.Post;
            request.RequestUri = new Uri(endpoint + route);
            request.Content = new StringContent(requestBody, Encoding.UTF8, "application/json");
            request.Headers.Add("Ocp-Apim-Subscription-Key", key);
            // location required if you're using a multi-service or regional (not global) resource.
            request.Headers.Add("Ocp-Apim-Subscription-Region", location);

            // Send the request and get response.
            HttpResponseMessage response = await client.SendAsync(request).ConfigureAwait(false);
            // Read response as a string.
            string result = await response.Content.ReadAsStringAsync();
            Console.WriteLine(result);
        }
    }
}

Menjalankan aplikasi C# Anda

Setelah Anda menambahkan sampel kode ke aplikasi, pilih tombol mulai hijau di samping formRecognizer_quickstart untuk membangun dan menjalankan program Anda, atau tekan F5.

Cuplikan layar tombol program eksekusi di Visual Studio.

Keluaran terjemahan:

Setelah panggilan berhasil, Anda akan melihat respons berikut:

[
    {
        "detectedLanguage": {
            "language": "en",
            "score": 1.0
        },
        "translations": [
            {
                "text": "J'aimerais vraiment conduire votre voiture autour du pâté de maisons plusieurs fois!",
                "to": "fr"
            },
            {
                "text": "Ngingathanda ngempela ukushayela imoto yakho endaweni evimbelayo izikhathi ezimbalwa!",
                "to": "zu"
            }
        ]
    }
]

Langkah berikutnya

Itu saja, selamat! Anda telah belajar menggunakan layanan Penerjemah untuk menerjemahkan teks.

Jelajahi dokumentasi petunjuk kami dan pelajari lebih dalam kemampuan layanan Terjemahan: