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

• Untuk panduan memulai ini, Anda disarankan untuk menggunakan langganan layanan tunggal teks Penerjemah.
• Dengan langganan 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 langganan Cognitive Services multi-layanan, langganan ini memerlukan dua header autentikasi (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, lihatMenggunakan 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:

    

• 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
Tipe-Konten	Jenis konten payload. Nilai yang diterima adalah application/json atau charset=UTF-8.	Diperlukan
Panjang-Konten	Panjang isi permintaan.	Opsional
X-ClientTraceId	GUID yang dibuat oleh klien untuk mengidentifikasi permintaan secara unik. Anda dapat menghilangkan header ini jika Anda menyertakan ID pelacakan dalam string kueri menggunakan parameter kueri bernama ClientTraceId.	Opsional

Penting

Jangan lupa menghapus kunci dari kode setelah Anda selesai, dan jangan pernah mempostingnya secara publik. Untuk produksi, gunakan metode aman untuk menyimpan dan mengakses info masuk Anda. Untuk mengetahui informasi selengkapnya, lihatKeamanan 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.

C#: Visual Studio

Siapkan

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

   Tip

   Jika Anda baru mengenal Visual Studio, coba modul Pengenalan pada Visual Studio Microsoft Learn.

2. Buka Visual Studio.

3. Dari halaman Mulai, pilih Buat proyek baru.

   

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

   

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.

   

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.

   

Menginstal paket Newtonsoft.json dengan NuGet

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

   

2. Pilih tab Telusur dan ketik Newtonsoft.json.

   

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

   

Bangun aplikasi 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";

    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);

            // 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.

Go

Menyiapkan lingkungan Go Anda

Anda dapat menggunakan editor teks apa pun untuk menulis aplikasi Go. Sebaiknya menggunakan versi terbaru Visual Studio Code dan ekstensi Go.

Tip

Jika Anda baru menggunakan Go, coba modul Mulai dengan Go Microsoft Learn.

1. Jika Anda belum melakukannya, unduh dan instal Go.

   • Unduh versi Go untuk sistem operasi Anda.

   • Setelah unduhan selesai, jalankan alat penginstal.

   • Buka perintah dan masukkan berikut ini untuk mengonfirmasi Go telah diinstal:

       go version
     

2. Di jendela konsol (seperti cmd, PowerShell, atau Bash), buat direktori baru untuk aplikasi Anda yang disebut translator-app, dan navigasikan ke direktori tersebut.

3. Buat nama file GO baru translation.go dari direktori translator-app.

4. Salin dan tempel sampel kode yang disediakan ke dalam file translation.go. Pastikan Anda memperbarui variabel kunci dengan nilai dari instans Penerjemah portal Azure:

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "log"
    "net/http"
    "net/url"
)

func main() {
    key := "<YOUR-TRANSLATOR-KEY>"
    // Add your location, also known as region. The default is global.
    // This is required if using a Cognitive Services resource.
    endpoint := "https://api.cognitive.microsofttranslator.com/"
    uri := endpoint + "/translate?api-version=3.0"

    // Build the request URL. See: https://go.dev/pkg/net/url/#example_URL_Parse
    u, _ := url.Parse(uri)
    q := u.Query()
    q.Add("from", "en")
    q.Add("to", "fr")
    q.Add("to", "zu")
    u.RawQuery = q.Encode()

    // Create an anonymous struct for your request body and encode it to JSON
    body := []struct {
        Text string
    }{
        {Text: "I would really like to drive your car around the block a few times."},
    }
    b, _ := json.Marshal(body)

    // Build the HTTP POST request
    req, err := http.NewRequest("POST", u.String(), bytes.NewBuffer(b))
    if err != nil {
        log.Fatal(err)
    }
    // Add required headers to the request
    req.Header.Add("Ocp-Apim-Subscription-Key", key)
    req.Header.Add("Content-Type", "application/json")

    // Call the Translator API
    res, err := http.DefaultClient.Do(req)
    if err != nil {
        log.Fatal(err)
    }

    // Decode the JSON response
    var result interface{}
    if err := json.NewDecoder(res.Body).Decode(&result); err != nil {
        log.Fatal(err)
    }
    // Format and print the response to terminal
    prettyJSON, _ := json.MarshalIndent(result, "", "  ")
    fmt.Printf("%s\n", prettyJSON)
}

Menjalankan aplikasi Go Anda

Setelah sampel kode ditambahkan ke aplikasi, program Go Anda dapat dijalankan dalam perintah atau permintaan terminal. Pastikan jalur permintaan Anda diatur ke folder translator-app dan menggunakan perintah berikut:

 go run translation.go

Java

Menyiapkan lingkungan Java Anda

• Anda harus memiliki versi terbaru Visual Studio Code atau IDE pilihan Anda. LihatJava di Visual Studio Code.

  Tip

  • Visual Studio Code menawarkan Paket Pengkodean untuk Java untuk Windows dan macOS.v Paket pengkodean adalah bundel Visual Studio Code, Java Development Kit (JDK), dan kumpulan ekstensi yang disarankan oleh Microsoft. Paket Pengkodean juga dapat digunakan untuk memperbaiki lingkungan pengembangan yang ada.
  • Jika Anda menggunakan Visual Studio Code dan Paket Pengkodean untuk Java, pasang ekstensi Gradle for Java.

• Jika Anda tidak menggunakan Visual Studio Code, pastikan Anda memasang hal berikut di lingkungan pengembangan:

  • Java Development Kit (OpenJDK) versi 8 atau yang lebih baru.

  • Gradle, versi 6.8 atau yang lebih baru.

Membuat proyek Gradle baru

1. Di jendela konsol (seperti cmd, PowerShell, atau Bash), buat direktori baru untuk aplikasi Anda yang disebut translator-text-app, dan navigasikan ke direktori tersebut.

   mkdir translator-text-app && translator-text-app
   

    mkdir translator-text-app; cd translator-text-app
   

2. Jalankan perintah gradle init dari direktori translator-text-app. Perintah ini akan membuat file build penting untuk Gradle, termasuk build.gradle.kts yang digunakan saat runtime bahasa umum untuk membuat dan mengonfigurasi aplikasi Anda.

   gradle init --type basic
   

3. Saat diminta untuk memilih DSL, pilih Kotlin.

4. Terima nama proyek default (translator-text-app) dengan memilih Kembali atau Masuk.

5. Perbarui build.gradle.kts dengan kode berikut:

plugins {
  java
  application
}
application {
  mainClass.set("TranslatorText")
}
repositories {
  mavenCentral()
}
dependencies {
  implementation("com.squareup.okhttp3:okhttp:4.10.0")
  implementation("com.google.code.gson:gson:2.9.0")
}

Membuat Aplikasi Java

1. Dari direktori translator-text-app, jalankan perintah berikut:

   mkdir -p src/main/java
   

   Anda akan membuat struktur direktori berikut:

   

2. Buka direktori java dan buat file bernama TranslatorText.java.

   Tip

   • Anda dapat membuat file baru menggunakan PowerShell.

   • Buka jendela PowerShell di direktori proyek Anda dengan menahan tombol Shift dan klik kanan folder.

   • Ketik perintah New-Item TranslatorText.java berikut.

   • Anda juga dapat membuat file baru di IDE bernama TranslatorText.java dan simpan file ke direktori java.

3. Buka file TranslatorText.java di IDE Anda dan salin kemudian tempel sampel kode berikut ke aplikasi Anda. Pastikan Anda memperbarui kunci dengan salah satu nilai kunci dari instans Penerjemah portal Azure Anda:

import java.io.IOException;

import com.google.gson.*;
import okhttp3.MediaType;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.RequestBody;
import okhttp3.Response;

public class TranslatorText {
    private static String key = "<your-translator-key";


    // Instantiates the OkHttpClient.
    OkHttpClient client = new OkHttpClient();

    // This function performs a POST request.
    public String Post() throws IOException {
        MediaType mediaType = MediaType.parse("application/json");
        RequestBody body = RequestBody.create(mediaType,
                "[{\"Text\": \"I would really like to drive your car around the block a few times!\"}]");
        Request request = new Request.Builder()
                .url("https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=fr&to=zu")
                .post(body)
                .addHeader("Ocp-Apim-Subscription-Key", key)
                .addHeader("Content-type", "application/json")
                .build();
        Response response = client.newCall(request).execute();
        return response.body().string();
    }

    // This function prettifies the json response.
    public static String prettify(String json_text) {
        JsonParser parser = new JsonParser();
        JsonElement json = parser.parse(json_text);
        Gson gson = new GsonBuilder().setPrettyPrinting().create();
        return gson.toJson(json);
    }

    public static void main(String[] args) {
        try {
            TranslatorText translateRequest = new TranslatorText();
            String response = translateRequest.Post();
            System.out.println(prettify(response));
        } catch (Exception e) {
            System.out.println(e);
        }
    }
}

Membangun dan menjalankan aplikasi Anda

Setelah Anda menambahkan sampel kode ke aplikasi, navigasikan kembali ke direktori proyek utama Anda—translator-text-app, buka jendela konsol, dan masukkan perintah berikut:

1. Bangun aplikasi Anda dengan perintah build:

   gradle build
   

2. Jalankan aplikasi dengan perintah run:

   gradle run
   

Node.js

Membuat aplikasi Ekspres Node.js

1. Jika Anda belum melakukannya, instal versi terbaru Node.js. Node Package Manager (npm) disertakan dengan penginstalan Node.js.

   Tip

   Jika Anda baru mengenal Node.js, coba modul Pengenalan Node.js Microsoft Learn.

2. Di jendela konsol (seperti cmd, PowerShell, atau Bash), buat dan navigasikan ke direktori baru untuk aplikasi Anda bernama translator-app.

       mkdir translator-app && cd translator-app
   

     mkdir translator-app; cd translator-app
   

3. Jalankan perintah npm init untuk menginisialisasi aplikasi dan scaffold proyek Anda.

      npm init
   

4. Tentukan atribut proyek Anda menggunakan petunjuk yang disajikan di terminal.

   • Atribut yang paling penting adalah nama, nomor versi, dan titik masuk.
   • Sebaiknya simpan index.js untuk nama titik masuk. Deskripsi, perintah pengujian, repositori GitHub, kata kunci, penulis, dan informasi lisensi adalah atribut opsional—atribut tersebut dapat dilewati untuk proyek ini.
   • Terima saran dalam tanda kurung dengan memilih Kembali atau Masukkan.
   • Setelah Anda menyelesaikan permintaan, file package.json akan dibuat di direktori translator-app Anda.

5. Buka jendela konsol dan gunakan npm untuk menginstal pustaka HTTP axios dan paket uuid:

      npm install axios uuid
   

6. Buat file index.js di direktori aplikasi.

   Tip

   • Anda dapat membuat file baru menggunakan PowerShell.

   • Buka jendela PowerShell di direktori proyek Anda dengan menahan tombol Shift dan klik kanan folder.

   • Ketik perintah berikut New-Item index.js.

   • Anda juga dapat membuat file baru bernama index.js di IDE Anda dan simpan file tersebut ke direktori translator-app.

7. Tambahkan kode sampel berikut ke file index.js Anda. Pastikan Anda memperbarui variabel kunci dengan nilai dari instans Penerjemah portal Azure Anda:

    const axios = require('axios').default;
    const { v4: uuidv4 } = require('uuid');

    let key = "<your-translator-key>";
    let endpoint = "https://api.cognitive.microsofttranslator.com";

    axios({
        baseURL: endpoint,
        url: '/translate',
        method: 'post',
        headers: {
            'Ocp-Apim-Subscription-Key': key,
            'Content-type': 'application/json',
            'X-ClientTraceId': uuidv4().toString()
        },
        params: {
            'api-version': '3.0',
            'from': 'en',
            'to': ['fr', 'zu']
        },
        data: [{
            'text': 'I would really like to drive your car around the block a few times!'
        }],
        responseType: 'json'
    }).then(function(response){
        console.log(JSON.stringify(response.data, null, 4));
    })

Menjalankan aplikasi

Setelah menambahkan sampel kode ke aplikasi, jalankan program Anda:

1. Navigasi ke direktori aplikasi Anda (translator-app).

2. Jalankan perintah berikut, di terminal Anda:

   node index.js
   

Python

Membuat aplikasi Python

1. Jika Anda belum melakukannya, instal versi terbaru Python 3.x. Paket alat penginstal Python (pip) disertakan dengan penginstalan Python.

   Tip

   Jika Anda baru mengenal Python, coba modul Pengenalan Python Microsoft Learn.

2. Buka jendela terminal dan gunakan pip untuk menginstal pustaka Permintaan dan paket uuid0:

      pip install requests uuid
   

   Catatan

   Kami juga akan menggunakan paket bawaan Python yang disebut json. Paket digunakan untuk bekerja dengan data JSON.

3. Buat file Python baru yang disebut translator-app.py di penyunting atau IDE pilihan Anda.

4. Tambahkan kode sampel berikut ke file translator-app.py Anda. Pastikan Anda memperbarui kunci dengan salah satu nilai dari instans Penerjemah portal Azure.

import requests, uuid, json

# Add your key and endpoint
key = "<your-translator-key>"
endpoint = "https://api.cognitive.microsofttranslator.com"

# Add your location, also known as region. The default is global.
# This is required if using a Cognitive Services resource.
location = "YOUR_RESOURCE_LOCATION"

path = '/translate'
constructed_url = endpoint + path

params = {
    'api-version': '3.0',
    'from': 'en',
    'to': ['fr', 'zu']
}

headers = {
    'Ocp-Apim-Subscription-Key': key,
    'Content-type': 'application/json',
    'X-ClientTraceId': str(uuid.uuid4())
}

# You can pass more than one object in body.
body = [{
    'text': 'I would really like to drive your car around the block a few times!'
}]

request = requests.post(constructed_url, params=params, headers=headers, json=body)
response = request.json()

print(json.dumps(response, sort_keys=True, ensure_ascii=False, indent=4, separators=(',', ': ')))

Menjalankan aplikasi python Anda

Setelah Anda menambahkan contoh kode ke aplikasi Anda, bangun dan jalankan program Anda:

1. Navigasi ke file translator-app.py Anda.

2. Ketik perintah berikut di konsol Anda:

   python translator-app.py
   

Output 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"
            }
        ]
    }
]

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

Langkah selanjutnya

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

• Terjemahkan teks

• Teks transliterasi

• Mendeteksi dan mengidentifikasi bahasa

• Dapatkan panjang kalimat

• Pencarian kamus dan terjemahan alternatif