Mulai menggunakan terjemahan dokumen asinkron

Artikel
02/23/2024

Terjemahan Dokumen adalah fitur berbasis cloud dari layanan azure AI Penerjemah yang secara asinkron menerjemahkan seluruh dokumen dalam bahasa yang didukung dan berbagai format file. Dalam mulai cepat ini, pelajari cara menggunakan Terjemahan Dokumen dengan bahasa pemrograman pilihan Anda untuk menerjemahkan dokumen sumber ke dalam bahasa target sambil mempertahankan struktur dan pemformatan teks.

Prasyarat

Penting

SDK Terjemahan Dokumen Java dan JavaScript saat ini tersedia dalam pratinjau publik. Fitur, pendekatan, dan proses dapat berubah, sebelum rilis ketersediaan umum (GA), berdasarkan umpan balik pengguna.
C# dan Python SDK adalah rilis ketersediaan umum (GA) yang siap digunakan dalam aplikasi produksi Anda
Terjemahan Dokumen saat ini hanya didukung dalam sumber daya Penerjemah (layanan tunggal), dan tidak disertakan dalam sumber daya layanan Azure AI (multi-layanan).
Penerjemahan Dokumen hanya didukung dalam Paket Layanan Standar S1 (Bayar sesuai pemakaian) atau dalam Paket Diskon Volume D3. LihatHarga layanan Azure AI—Penerjemah.

Untuk memulai, Anda memerlukan:

Akun Azure aktif. Jika Anda tidak memilikinya, Anda dapat membuat akun gratis
Akun Azure Blob Storage. Anda juga perlu membuat kontainer di akun Azure Blob Storage untuk file sumber dan target Anda:
- Kontainer sumber. Kontainer ini adalah tempat Anda mengunggah file yang akan diterjemahkan (wajib).
- Kontainer target. Kontainer ini adalah tempat file terjemahan Anda disimpan (diperlukan).
Sumber daya Penerjemah layanan tunggal (bukan sumber daya layanan Azure AI multi-layanan):

Selesaikan proyek Penerjemah dan bidang detail instans sebagai berikut:
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 identitas terkelola yang ditetapkan sistem untuk autentikasi, pilih wilayah geografis seperti AS Barat.
4. Nama. Masukkan nama yang Anda pilih untuk sumber daya Anda. Nama yang Anda pilih harus unik dalam Azure.
  
  Catatan
  
  Penerjemahan Dokumen memerlukan titik akhir domain kustom. Nilai yang Anda masukkan dalam bidang Nama akan menjadi parameter nama domain kustom untuk titik akhir.
5. Tingkat harga. Penerjemahan Dokumen tidak didukung di tingkat gratis. Pilih Standar S1 untuk mencoba layanan.
6. Pilih Tinjau + Buat.
7. Tinjau ketentuan layanan dan pilih Buat untuk menyebarkan sumber daya Anda.
8. Setelah sumber daya Anda berhasil disebarkan, pilih Buka sumber daya.

Mengambil titik akhir terjemahan kunci dan dokumen Anda

Permintaan ke layanan Penerjemah memerlukan kunci baca-saja dan titik akhir kustom untuk mengautentikasi akses. Titik akhir domain kustom adalah URL yang diformat dengan nama sumber daya, nama host, dan subdirektori Penerjemah Anda dan tersedia di portal Azure.

Jika Anda membuat sumber daya baru, setelah disebarkan, pilih Buka sumber daya. Jika Anda memiliki sumber daya Terjemahan Dokumen yang sudah ada, langsung buka halaman sumber daya.
Di rel kiri, di bagian Manajemen Sumber Daya, pilih Kunci dan Titik Akhir.
Anda dapat menyalin dan menempelkan dan keydocument translation endpoint ke dalam sampel kode untuk mengautentikasi permintaan Anda ke layanan Terjemahan Dokumen. Hanya satu kunci yang diperlukan untuk melakukan panggilan API.

Membuat kontainer Azure Blob Storage

Anda perlu membuat kontainer di akun Azure Blob Storage untuk file sumber dan target.

Kontainer sumber. Kontainer ini adalah tempat Anda mengunggah file yang akan diterjemahkan (wajib).
Kontainer target. Kontainer ini adalah tempat file terjemahan Anda disimpan (diperlukan).

Autentikasi yang diperlukan

sourceUrl, targetUrl, dan glossaryUrl opsional harus menyertakan token Tanda Tangan Akses Bersama (SAS), yang ditambahkan sebagai string kueri. Token dapat ditetapkan ke kontainer Anda atau blob tertentu. LihatBuka token SAS untuk proses Penerjemahan Dokumen.

Kontainer sumber atau blob Anda harus menunjuk akses baca dan daftar.
Kontainer atau blob target Anda harus menunjuk akses tulis dan daftar.
Blob glosarium Anda harus menunjuk akses baca dan daftar.

Tip

Jika Anda menerjemahkan beberapa file (blob) dalam suatu operasi, delegasikan akses SAS pada tingkat kontainer.
Jika Anda menerjemahkan satu file (blob) dalam operasi, delegasikan akses SAS di tingkat blob.
Sebagai alternatif token SAS, Anda dapat menggunakan identitas terkelola yang ditetapkan sistem untuk autentikasi.

Sampel dokumen

Untuk proyek ini, Anda memerlukan dokumen sumber yang diunggah ke kontainer sumber Anda. Anda dapat mengunduh dokumen sampel terjemahan dokumen kami untuk mulai cepat ini. Bahasa sumbernya adalah bahasa Inggris.

Menyiapkan lingkungan C#/.NET Anda

Untuk mulai cepat ini, kami menggunakan versi terbaru Visual Studio IDE untuk membangun dan menjalankan aplikasi.

Mulai Visual Studio.
Pada halaman Memulai , pilih Buat proyek baru.
Pada halaman Buat proyek baru, masukkan konsol di kotak pencarian. Pilih templat Aplikasi Konsol, lalu pilih Berikutnya.
Di jendela dialog Konfigurasikan proyek baru Anda, masukkan document-translation-qs di kotak Nama proyek. Kemudian pilih Berikutnya.
Di jendela dialog Informasi tambahan, pilih .NET 6.0 (Dukungan jangka panjang), lalu pilih Buat.

Menginstal Newtonsoft.Json

Klik kanan pada proyek document-translation-qs Anda dan pilih Kelola Paket NuGet... .
Pilih tab Telusuri dan ketik NewtonsoftJson.
Pilih versi stabil terbaru dari menu dropdown dan instal paket di proyek Anda.

Menerjemahkan semua dokumen dalam kontainer penyimpanan

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, lihat Templat C# baru menghasilkan pernyataan tingkat atas.

Buka file Program.cs.
Hapus kode yang sudah ada sebelumnya, termasuk baris Console.WriteLine("Hello World!").
Salin dan tempel sampel kode terjemahan dokumen ke dalam file Program.cs.
- Perbarui {your-document-translation-endpoint} dan {your-key} dengan nilai dari instans portal Azure Penerjemah Anda.
- Perbarui {your-source-container-SAS-URL} dan {your-target-container-SAS-URL} dengan nilai dari instans kontainer akun portal Azure Storage Anda.

Sampel kode

Penting

Jangan lupa menghapus kunci dari kode setelah Anda selesai, dan jangan pernah mempostingnya secara publik. Untuk produksi, gunakan cara yang aman untuk menyimpan dan mengakses kredensial Anda seperti Azure Key Vault. Untuk informasi selengkapnya, lihat Keamanan layanan Azure AI.

using System.Text;

class Program
{
    private static readonly string endpoint = "{your-document-translator-endpoint}/translator/text/batch/v1.1";

    private static readonly string key = "{your-key}";

    static readonly string route = "/batches";
    static readonly string sourceURL = "\" {your-source-container-SAS-URL}\"";
    static readonly string targetURL = " \"{your-target-container-SAS-URL}\"";


    static readonly string json = ("{\"inputs\": [{\"source\": {\"sourceUrl\":"+sourceURL+" ,\"storageSource\": \"AzureBlob\",\"language\": \"en\"}, \"targets\": [{\"targetUrl\":"+targetURL+",\"storageSource\": \"AzureBlob\",\"category\": \"general\",\"language\": \"es\"}]}]}");

    static async Task Main(string[] args)
    {
        using HttpClient client = new HttpClient();
        using HttpRequestMessage request = new HttpRequestMessage();
        {

            StringContent content = new StringContent(json, Encoding.UTF8, "application/json");

            request.Method = HttpMethod.Post;
            request.RequestUri = new Uri(endpoint + route);
            request.Headers.Add("Ocp-Apim-Subscription-Key", key);
            request.Content = content;

            HttpResponseMessage response = await client.SendAsync(request);
            string result = response.Content.ReadAsStringAsync().Result;
            if (response.IsSuccessStatusCode)
            {
                Console.WriteLine($"Status code: {response.StatusCode}");
                Console.WriteLine();
                Console.WriteLine($"Response Headers:");
                Console.WriteLine(response.Headers);
            }
            else
                Console.Write("Error");

        }

    }

}

Jalankan aplikasi Anda

Setelah Anda menambahkan sampel kode ke aplikasi, pilih tombol Mulai hijau di samping document-translation-qs untuk membangun dan menjalankan program Anda, atau tekan F5.

Screenshot: run your Visual Studio program.

Setelah berhasil diselesaikan:

Dokumen yang diterjemahkan dapat ditemukan di kontainer target Anda.
Metode POST yang berhasil mengembalikan kode respons yang 202 Accepted menunjukkan bahwa layanan membuat permintaan batch.
Permintaan POST juga mengembalikan header respons termasuk Operation-Location yang menyediakan nilai yang digunakan dalam permintaan GET berikutnya.

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 mengenal Go, coba modul Learn Memulai Go.

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
```

Menerjemahkan semua dokumen dalam kontainer penyimpanan

Di jendela konsol (seperti cmd, PowerShell, atau Bash), buat direktori baru untuk aplikasi Anda yang disebut document-translation-qs, dan navigasikan ke dalamnya.
Buat file Go baru bernama document-translation.go di direktori document-translation-qs .
Salin dan tempel sampel kode terjemahan dokumen ke file document-translation.go Anda.
- Perbarui {your-document-translation-endpoint} dan {your-key} dengan nilai dari instans portal Azure Penerjemah Anda.
- {your-source-container-SAS-URL} Perbarui dan {your-target-container-SAS-URL} dengan nilai dari instans kontainer akun penyimpanan portal Azure Anda.

Sampel kode

Penting

package main

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

func main() {

    httpposturl := "{your-document-translation-endpoint}/translator/text/batch/v1.1/batches"
    fmt.Println("Response", httpposturl)

    var jsonData = []byte(`{
        "inputs": [
            {
                "source": {
                    "sourceUrl": "{your-source-container-SAS-URL}"
                },
                "targets": [
                    {
                        "{your-target-container-SAS-URL}",
                        "language": "fr"
                    }
                ]
            }
        ]
    }`)

    request, error := http.NewRequest("POST", httpposturl, bytes.NewBuffer(jsonData))
    request.Header.Set("Content-Type", "application/json")
    request.Header.Set("Ocp-Apim-Subscription-Key", "{your-key}")

    client := &http.Client{}
    response, error := client.Do(request)
    if error != nil {
        panic(error)
    }
    defer response.Body.Close()

    fmt.Println("response Status:", response.Status)
    var printHeader = (response.Header)
    prettyJSON, _ := json.MarshalIndent(printHeader, "", "  ")
    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 prompt Anda diatur ke folder document-translation-qs dan gunakan perintah berikut:

go run document-translation.go

Setelah berhasil diselesaikan:

Dokumen yang diterjemahkan dapat ditemukan di kontainer target Anda.
Metode POST yang berhasil mengembalikan kode respons yang 202 Accepted menunjukkan bahwa layanan membuat permintaan batch.
Permintaan POST juga mengembalikan header respons termasuk Operation-Location yang menyediakan nilai yang digunakan dalam permintaan GET berikutnya.

Saya berhasil menerjemahkan dokumen saya.Aku mengalami masalah.

Menyiapkan lingkungan Java Anda

Untuk mulai cepat ini, kami menggunakan alat otomatisasi build Gradle untuk membuat dan menjalankan aplikasi.

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 memiliki hal berikut yang terinstal di lingkungan pengembangan Anda:
- Java Development Kit (OpenJDK) versi 8 atau yang lebih baru.
- Gradle, versi 6.8 atau yang lebih baru.

Buat proyek Gradle baru

Di jendela konsol (seperti cmd, PowerShell, atau Bash), buat direktori baru untuk aplikasi Anda yang disebut terjemahan dokumen, dan navigasikan ke dalamnya.
```
mkdir document-translation && document-translation
```
```
mkdir document-translation; cd document-translation
```
Jalankan gradle init perintah dari direktori terjemahan dokumen. Perintah ini membuat file build penting untuk Gradle, termasuk build.gradle.kts, yang digunakan pada runtime untuk membuat dan mengonfigurasi aplikasi Anda.
```
gradle init --type basic
```
Saat diminta untuk memilih DSL, pilih Kotlin.
Terima nama proyek default (terjemahan dokumen) dengan memilih Kembalikan atau Masukkan.

Catatan

Mungkin perlu beberapa menit agar seluruh aplikasi dibuat, tetapi segera Anda akan melihat beberapa folder dan file termasuk build-gradle.kts.
Perbarui build.gradle.kts dengan kode berikut:

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

Menerjemahkan semua dokumen dalam kontainer penyimpanan

Dari direktori terjemahan dokumen, jalankan perintah berikut:
```
mkdir -p src/main/java
```
Perintah membuat struktur direktori berikut:
Buka direktori java dan buat file bernama DocumentTranslation.java.
Tip
- Anda dapat membuat file baru menggunakan PowerShell.
- Buka jendela PowerShell di direktori proyek Anda dengan menahan tombol Shift dan klik kanan folder.
- Masukkan perintah berikut DocumentTranslation.java Item Baru.
- Anda juga dapat membuat file baru di IDE bernama DocumentTranslation.java dan simpan file ke direktori java.
Salin dan tempel sampel kode terjemahan dokumen ke dalam file DocumentTranslation.java Anda.
- Perbarui {your-document-translation-endpoint} dan {your-key} dengan nilai dari instans portal Azure Penerjemah Anda.
- {your-source-container-SAS-URL} Perbarui dan {your-target-container-SAS-URL} dengan nilai dari instans kontainer akun penyimpanan portal Azure Anda.

Sampel kode

Penting

import java.io.*;
import java.net.*;
import java.util.*;
import okhttp3.*;

public class DocumentTranslation {
    String key = "{your-key}";

    String endpoint = "{your-document-translation-endpoint}/translator/text/batch/v1.1";

    String path = endpoint + "/batches";

    String sourceSASUrl = "{your-source-container-SAS-URL}";

    String targetSASUrl = "{your-target-container-SAS-URL}";

    String jsonInputString = (String.format("{\"inputs\":[{\"source\":{\"sourceUrl\":\"%s\"},\"targets\":[{\"targetUrl\":\"%s\",\"language\":\"fr\"}]}]}", sourceSASUrl, targetSASUrl));

    OkHttpClient client = new OkHttpClient();

    public void post() throws IOException {
        MediaType mediaType = MediaType.parse("application/json");
        RequestBody body = RequestBody.create(mediaType,  jsonInputString);
        Request request = new Request.Builder()
                .url(path).post(body)
                .addHeader("Ocp-Apim-Subscription-Key", key)
                .addHeader("Content-type", "application/json")
                .build();
        Response response = client.newCall(request).execute();
        System.out.println(response.code());
        System.out.println(response.headers());
    }

  public static void main(String[] args) {
        try {
            DocumentTranslation sampleRequest = new DocumentTranslation();
            sampleRequest.post();
        } catch (Exception e) {
            System.out.println(e);
        }
    }
}

Membangun dan menjalankan aplikasi Java Anda

Setelah Anda menambahkan sampel kode ke aplikasi, navigasikan kembali ke direktori proyek utama Anda, terjemahan dokumen, buka jendela konsol, dan masukkan perintah berikut:
1. Bangun aplikasi Anda dengan perintah build:
```
gradle build
```
2. Jalankan aplikasi dengan perintah run:
```
gradle run
```

Setelah berhasil diselesaikan:

Dokumen yang diterjemahkan dapat ditemukan di kontainer target Anda.
Metode POST yang berhasil mengembalikan kode respons yang 202 Accepted menunjukkan bahwa layanan membuat permintaan batch.
Permintaan POST juga mengembalikan header respons termasuk Operation-Location yang menyediakan nilai yang digunakan dalam permintaan GET berikutnya.

Saya berhasil menerjemahkan dokumen saya.Aku mengalami masalah.

Menyiapkan lingkungan Node.js Anda

Untuk mulai cepat ini, kami menggunakan lingkungan runtime Node.js JavaScript untuk membuat dan menjalankan aplikasi.

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 Learn Pengantar untuk Node.js.
Di jendela konsol (seperti cmd, PowerShell, atau Bash), buat dan navigasikan ke direktori baru untuk aplikasi Anda bernama document-translation.
```
mkdir document-translation && cd document-translation
```
```
mkdir document-translation; cd document-translation
```
Jalankan perintah npm init untuk menginisialisasi aplikasi dan scaffold proyek Anda.
```
npm init
```
Tentukan atribut proyek Anda dengan menerima perintah 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 perintah, package.json file akan dibuat di direktori terjemahan dokumen Anda.
Gunakan npm untuk menginstal axios pustaka HTTP dan uuid paket di direktori aplikasi terjemahan dokumen Anda:
```
npm install axios uuid
```

Menerjemahkan semua dokumen dalam kontainer penyimpanan

index.js Buat file 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.
- Masukkan perintah berikut index.js Item Baru.
- Anda juga dapat membuat file baru bernama index.js di IDE Anda dan menyimpannya ke document-translation direktori.
Salin dan tempel sampel kode terjemahan dokumen ke dalam file Andaindex.js.
- Perbarui {your-document-translation-endpoint} dan {your-key} dengan nilai dari instans portal Azure Penerjemah Anda.
- {your-source-container-SAS-URL} Perbarui dan {your-target-container-SAS-URL} dengan nilai dari instans kontainer akun penyimpanan portal Azure Anda.

Sampel kode

Penting

const axios = require('axios').default;

let endpoint = '{your-document-translation-endpoint}/translator/text/batch/v1.1';
let route = '/batches';
let key = '{your-key}';
let sourceSASUrl = "{your-source-container-SAS-URL}";
let targetSASUrl = "{your-target-container-SAS-URL}"

let data = JSON.stringify({"inputs": [
  {
      "source": {
          "sourceUrl": sourceSASUrl,
          "storageSource": "AzureBlob",
          "language": "en"
      },
      "targets": [
          {
              "targetUrl": targetSASUrl,
              "storageSource": "AzureBlob",
              "category": "general",
              "language": "es"}]}]});

let config = {
  method: 'post',
  baseURL: endpoint,
  url: route,
  headers: {
    'Ocp-Apim-Subscription-Key': key,
    'Content-Type': 'application/json'
  },
  data: data
};

axios(config)
.then(function (response) {
  let result = { statusText: response.statusText, statusCode: response.status, headers: response.headers };
  console.log()
  console.log(JSON.stringify(result, null, 2));
})
.catch(function (error) {
  console.log(error);
});

Menjalankan aplikasi JavaScript Anda

Setelah menambahkan sampel kode ke aplikasi, jalankan program Anda:

Navigasi ke direktori aplikasi Anda (terjemahan dokumen).
Masukkan dan jalankan perintah berikut di terminal Anda:
```
node index.js
```

Setelah berhasil diselesaikan:

Dokumen yang diterjemahkan dapat ditemukan di kontainer target Anda.
Metode POST yang berhasil mengembalikan kode respons yang 202 Accepted menunjukkan bahwa layanan membuat permintaan batch.
Permintaan POST juga mengembalikan header respons termasuk Operation-Location yang menyediakan nilai yang digunakan dalam permintaan GET berikutnya.

Saya berhasil menerjemahkan dokumen saya.Aku mengalami masalah.

Menyiapkan proyek Python Anda

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 Learn Pengantar untuk Python.
Buka jendela terminal dan gunakan pip untuk menginstal pustaka Permintaan dan paket uuid0:
```
pip install requests uuid
```

Menerjemahkan semua dokumen dalam kontainer penyimpanan

Dengan menggunakan editor atau IDE pilihan Anda, buat direktori baru untuk aplikasi Anda bernama document-translation.
Buat file Python baru yang disebut document-translation.py di direktori terjemahan dokumen Anda.
Salin dan tempel sampel kode terjemahan dokumen ke dalam file Andadocument-translation.py.
- Perbarui {your-document-translation-endpoint} dan {your-key} dengan nilai dari instans portal Azure Penerjemah Anda.
- {your-source-container-SAS-URL} Perbarui dan {your-target-container-SAS-URL} dengan nilai dari instans kontainer akun penyimpanan portal Azure Anda.

Sampel kode

Penting

import requests

endpoint = '{your-document-translation-endpoint}'
key =  '{your-key}'
path = 'translator/text/batch/v1.1/batches'
constructed_url = endpoint + path

sourceSASUrl = '{your-source-container-SAS-URL}'

targetSASUrl = '{your-target-container-SAS-URL}'

body= {
    "inputs": [
        {
            "source": {
                "sourceUrl": sourceSASUrl,
                "storageSource": "AzureBlob",
                "language": "en"
            },
            "targets": [
                {
                    "targetUrl": targetSASUrl,
                    "storageSource": "AzureBlob",
                    "category": "general",
                    "language": "es"
                }
            ]
        }
    ]
}
headers = {
  'Ocp-Apim-Subscription-Key': key,
  'Content-Type': 'application/json',
}

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

print(f'response status code: {response.status_code}\nresponse status: {response.reason}\n\nresponse headers:\n')

for key, value in response_headers.items():
    print(key, ":", value)

Menjalankan aplikasi Python Anda

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

Navigasi ke direktori terjemahan dokumen Anda.
Masukkan dan jalankan perintah berikut di konsol Anda:
```
python document-translation.py
```

Setelah berhasil diselesaikan:

Dokumen yang diterjemahkan dapat ditemukan di kontainer target Anda.
Metode POST yang berhasil mengembalikan kode respons yang 202 Accepted menunjukkan bahwa layanan membuat permintaan batch.
Permintaan POST juga mengembalikan header respons termasuk Operation-Location yang menyediakan nilai yang digunakan dalam permintaan GET berikutnya.

Saya berhasil menerjemahkan dokumen saya.Aku mengalami masalah.

Menyiapkan lingkungan pemrograman Anda

Dalam mulai cepat ini, kami menggunakan alat baris perintah cURL untuk melakukan panggilan REST API Terjemahan Dokumen.

Catatan

Paket cURL telah diinstal sebelumnya pada sebagian besar Windows 10 dan Windows 11 dan sebagian besar distribusi macOS dan Linux. Anda dapat memeriksa versi paket dengan perintah berikut: Windows: curl.exe -V. macOS curl -V Linux: curl --version

Jika cURL tidak diinstal, berikut adalah tautan untuk platform Anda:

Windows.
Mac atau Linux.

Menerjemahkan dokumen (Permintaan POST)

Dengan menggunakan editor atau IDE pilihan Anda, buat direktori baru untuk aplikasi Anda bernama document-translation.
Buat file json baru yang disebut document-translation.json di direktori terjemahan dokumen Anda.
Salin dan tempel sampel permintaan terjemahan dokumen ke dalam file Andadocument-translation.json. Ganti {your-source-container-SAS-URL} dan {your-target-container-SAS-URL} dengan nilai dari instans kontainer akun penyimpanan portal Azure Anda.

Sampel permintaan:
```
{
  "inputs":[
    {
      "source":{
        "sourceUrl":"{your-source-container-SAS-URL}"
      },
      "targets":[
        {
          "targetUrl":"{your-target-container-SAS-URL}",
          "language":"fr"
        }
      ]
    }
  ]
}
```

Membangun dan menjalankan permintaan POST

Sebelum Anda menjalankan permintaan POST, ganti {your-document-translator-endpoint} dan {your-key} dengan nilai dari instans portal Azure Penerjemah Anda.

Penting

PowerShell

cmd /c curl "{your-document-translator-endpoint}/translator/text/batch/v1.1/batches" -i -X POST --header "Content-Type: application/json" --header "Ocp-Apim-Subscription-Key: {your-key}" --data "@document-translation.json"

command prompt / terminal

curl "{your-document-translator-endpoint}/translator/text/batch/v1.1/batches" -i -X POST --header "Content-Type: application/json" --header "Ocp-Apim-Subscription-Key: {your-key}" --data "@document-translation.json"

Setelah berhasil diselesaikan:

Dokumen yang diterjemahkan dapat ditemukan di kontainer target Anda.
Metode POST yang berhasil mengembalikan kode respons yang 202 Accepted menunjukkan bahwa layanan membuat permintaan batch.
Permintaan POST juga mengembalikan header respons termasuk Operation-Location yang menyediakan nilai yang digunakan dalam permintaan GET berikutnya.

Itu saja, selamat! Dalam mulai cepat ini, Anda menggunakan Terjemahan Dokumen untuk menerjemahkan dokumen sambil mempertahankan struktur dan format data aslinya.

Langkah berikutnya

Pelajari selengkapnya tentang operasi Terjemahan Dokumen

Mulai menggunakan terjemahan dokumen asinkron

Prasyarat

Mengambil titik akhir terjemahan kunci dan dokumen Anda

Membuat kontainer Azure Blob Storage

Autentikasi yang diperlukan

Sampel dokumen

Menyiapkan lingkungan C#/.NET Anda

Menginstal Newtonsoft.Json

Menerjemahkan semua dokumen dalam kontainer penyimpanan

Sampel kode

Jalankan aplikasi Anda

Menyiapkan lingkungan Go Anda

Menerjemahkan semua dokumen dalam kontainer penyimpanan

Sampel kode

Menjalankan aplikasi Go Anda

Menyiapkan lingkungan Java Anda

Buat proyek Gradle baru

Menerjemahkan semua dokumen dalam kontainer penyimpanan

Sampel kode

Membangun dan menjalankan aplikasi Java Anda

Menyiapkan lingkungan Node.js Anda

Menerjemahkan semua dokumen dalam kontainer penyimpanan

Sampel kode

Menjalankan aplikasi JavaScript Anda

Menyiapkan proyek Python Anda

Menerjemahkan semua dokumen dalam kontainer penyimpanan

Sampel kode

Menjalankan aplikasi Python Anda

Menyiapkan lingkungan pemrograman Anda

Menerjemahkan dokumen (Permintaan POST)

Membangun dan menjalankan permintaan POST

Langkah berikutnya

Sumber Daya Tambahan: