Zaman uyumsuz belge çevirisi kullanmaya başlama
Belge Çevirisi, Azure AI Çeviri hizmetinin desteklenen dillerde ve çeşitli dosya biçimlerinde belgelerin tamamını zaman uyumsuz olarak çeviren bulut tabanlı bir özelliğidir. Bu hızlı başlangıçta, kaynak belgeyi hedef dile çevirmek için seçtiğiniz bir programlama diliyle Belge Çevirisi'ni kullanmayı ve yapıyı ve metin biçimlendirmesini korumayı öğrenin.
Önkoşullar
Önemli
Java ve JavaScript Belge Çevirisi SDK'ları şu anda genel önizlemede kullanılabilir. Özellikler, yaklaşımlar ve süreçler, genel kullanılabilirlik (GA) sürümünden önce, kullanıcı geri bildirimlerine bağlı olarak değişebilir.
C# ve Python SDK'ları, üretim uygulamalarınızda kullanıma hazır genel kullanılabilirlik (GA) sürümleridir
Belge Çevirisi şu anda yalnızca Çeviri (tek hizmetli) kaynakta desteklenir ve Azure AI hizmetleri (çok hizmetli) kaynağına dahil değildir.
Belge Çevirisi yalnızca S1 Standart Hizmet Planı'nda (kullandıkça öde) veya D3 Toplu İndirim Planı'nda desteklenir. Bkz.Azure AI hizmetleri fiyatlandırması— Çeviri.
Başlamak için gerekli olanlar:
Etkin bir Azure hesabı. Hesabınız yoksa ücretsiz bir hesap oluşturabilirsiniz
bir Azure Blob Depolama hesabı. Ayrıca kaynak ve hedef dosyalarınız için Azure Blob Depolama hesabınızda kapsayıcılar oluşturmanız gerekir:
- Kaynak kapsayıcı. Bu kapsayıcı, dosyalarınızı çeviri için karşıya yüklediğiniz yerdir (gerekli).
- Hedef kapsayıcı. Bu kapsayıcı, çevrilen dosyalarınızın depolandığı yerdir (gereklidir).
Tek hizmetli Çeviri kaynağı (çok hizmetli bir Azure AI hizmetleri kaynağı değil):
Çeviri proje ve örnek ayrıntıları alanlarını aşağıdaki gibi tamamlayın:
Abonelik. Kullanılabilir Azure aboneliklerinizden birini seçin.
Kaynak Grubu. Yeni bir kaynak grubu oluşturabilir veya kaynağınızı aynı yaşam döngüsünü, izinleri ve ilkeleri paylaşan önceden var olan bir kaynak grubuna ekleyebilirsiniz.
Kaynak Bölgesi. İşletmeniz veya uygulamanız belirli bir bölge gerektirmediği sürece Genel'i seçin. Kimlik doğrulaması için sistem tarafından atanan yönetilen kimlik kullanmayı planlıyorsanız Batı ABD gibi bir coğrafi bölge seçin.
Adı. Kaynağınız için seçtiğiniz adı girin. Seçtiğiniz ad Azure içinde benzersiz olmalıdır.
Not
Belge Çevirisi için özel bir etki alanı uç noktası gerekir. Ad alanına girdiğiniz değer, uç noktanız için özel etki alanı adı parametresi olacaktır.
Fiyatlandırma katmanı. Belge Çevirisi ücretsiz katmanda desteklenmez. Hizmeti denemek için Standart S1'i seçin.
Gözden geçir + Oluştur’u seçin.
Hizmet koşullarını gözden geçirin ve kaynağınızı dağıtmak için Oluştur'u seçin.
Kaynağınız başarıyla dağıtıldıktan sonra Kaynağa git'i seçin.
Anahtarınızı ve belge çevirisi uç noktanızı alma
Çeviri hizmetine yönelik istekler, erişimin kimliğini doğrulamak için salt okunur bir anahtar ve özel uç nokta gerektirir. Özel etki alanı uç noktası kaynak adınız, ana bilgisayar adınız ve Çeviri alt dizinlerinizle biçimlendirilmiş bir URL'dir ve Azure portalında kullanılabilir.
Yeni bir kaynak oluşturduysanız, dağıtıldıktan sonra Kaynağa git'i seçin. Mevcut bir Belge Çevirisi kaynağınız varsa doğrudan kaynak sayfanıza gidin.
Sol rayda, Kaynak Yönetimi'nin altında Anahtarlar ve Uç Nokta'yı seçin.
belge çevirisi hizmetine isteğinizin kimliğini doğrulamak için ve kod örneklerine kopyalayıp yapıştırabilirsiniz
key
document translation endpoint
. API çağrısı yapmak için yalnızca bir anahtar gerekir.
Azure Blob Depolama kapsayıcıları oluşturma
Kaynak ve hedef dosyalar için Azure Blob Depolama hesabınızda kapsayıcılaroluşturmanız gerekir.
- Kaynak kapsayıcı. Bu kapsayıcı, dosyalarınızı çeviri için karşıya yüklediğiniz yerdir (gerekli).
- Hedef kapsayıcı. Bu kapsayıcı, çevrilen dosyalarınızın depolandığı yerdir (gereklidir).
Gerekli kimlik doğrulaması
sourceUrl
, targetUrl
ve isteğe bağlıglossaryUrl
, sorgu dizesi olarak eklenmiş bir Paylaşılan Erişim İmzası (SAS) belirteci içermelidir. Belirteç kapsayıcınıza veya belirli bloblara atanabilir. Bkz. Belge Çevirisi işlemi için SAS belirteçleri oluşturma.
- Kaynak kapsayıcınızın veya blobunuzun okuma ve liste erişimi belirlemesi gerekir.
- Hedef kapsayıcınızın veya blobunuzun yazma ve liste erişimi belirlemesi gerekir.
- Sözlük blobunuzun okuma ve liste erişimi belirlemesigerekir.
İpucu
- Bir işlemde birden çok dosya (blob) çeviriyorsanız, kapsayıcı düzeyinde SAS erişimini temsilci olarak belirleyin.
- Bir işlemde tek bir dosyayı (blob) çeviriyorsanız, blob düzeyinde SAS erişimini temsilci olarak belirleyin.
- SAS belirteçlerine alternatif olarak, kimlik doğrulaması için sistem tarafından atanan yönetilen kimliği kullanabilirsiniz.
Örnek belge
Bu proje için kaynak kapsayıcınıza yüklenmiş bir kaynak belge gerekir. Bu hızlı başlangıç için belge çevirisi örnek belgemizi indirebilirsiniz. Kaynak dil İngilizcedir.
C#/.NET ortamınızı ayarlama
Bu hızlı başlangıçta, uygulamayı derlemek ve çalıştırmak için Visual Studio IDE'nin en son sürümünü kullanırız.
Visual Studio’yu çalıştırın.
Başlarken sayfasında Yeni proje oluştur'u seçin.
Yeni proje oluştur sayfasında, arama kutusuna konsol yazın. Konsol Uygulaması şablonunu ve ardından İleri'yi seçin.
Yeni projenizi yapılandırın iletişim penceresinde Proje adı kutusuna girin
document-translation-qs
. Ardından İleri'yi seçin.Ek bilgiler iletişim kutusunda .NET 6.0 (uzun süreli destek) öğesini ve ardından Oluştur'u seçin.
Newtonsoft.Json yükleme
Document-translation-qs projenize sağ tıklayın ve NuGet Paketlerini Yönet... öğesini seçin.
Gözat sekmesini seçin ve NewtonsoftJson yazın.
Açılan menüden en son kararlı sürümü seçin ve paketi projenize yükleyin.
Depolama kapsayıcısında tüm belgeleri çevirme
Not
- .NET 6'dan başlayarak, şablonu kullanan
console
yeni projeler önceki sürümlerden farklı yeni bir program stili oluşturur. - Yeni çıkış, yazmanız gereken kodu basitleştiren son C# özelliklerini kullanır.
- Daha yeni sürümü kullandığınızda, yalnızca yönteminin gövdesini
Main
yazmanız gerekir. Üst düzey deyimleri, genel using yönergelerini veya örtük using yönergelerini eklemeniz gerekmez. - Daha fazla bilgi için bkz . Yeni C# şablonları üst düzey deyimler oluşturma.
Program.cs dosyasını açın.
satırı
Console.WriteLine("Hello World!")
da dahil olmak üzere önceden var olan kodu silin.Belge çevirisi kodu örneğini kopyalayıp Program.cs dosyasına yapıştırın.
Azure portal Çeviri örneğinizdeki değerlerle ve
{your-key}
değerlerini güncelleştirin{your-document-translation-endpoint}
.Azure portal Depolama hesap kapsayıcıları örneğinizdeki değerlerle ve
{your-target-container-SAS-URL}
değerlerini güncelleştirin{your-source-container-SAS-URL}
.
Kod örneği
Önemli
İşiniz bittiğinde anahtarı kodunuzdan kaldırmayı unutmayın ve asla herkese açık olarak göndermeyin. Üretim için Azure Key Vault gibi kimlik bilgilerinizi depolamanın ve bunlara erişmenin güvenli bir yolunu kullanın. Daha fazla bilgi için bkz . Azure AI hizmetleri güvenliği.
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");
}
}
}
Uygulamanızı çalıştırma
Uygulamanıza bir kod örneği ekledikten sonra, programınızı derlemek ve çalıştırmak için document-translation-qs öğesinin yanındaki yeşil Başlangıç düğmesini seçin veya F5 tuşuna basın.
Başarıyla tamamlandıktan sonra:
- Çevrilen belgeler hedef kapsayıcınızda bulunabilir.
- Başarılı POST yöntemi, hizmetin toplu iş isteğini oluşturduğunu belirten bir
202 Accepted
yanıt kodu döndürür. - POST isteği, sonraki GET isteklerinde kullanılan bir değer sağlayan yanıt üst bilgilerini
Operation-Location
de döndürür.
Go ortamınızı ayarlama
Go uygulamaları yazmak için herhangi bir metin düzenleyicisini kullanabilirsiniz. Visual Studio Code'un en son sürümünü ve Go uzantısını kullanmanızı öneririz.
İpucu
Go'yu kullanmaya yeni başladıysanız Go Learn ile çalışmaya başlama modülünü deneyin.
Henüz yapmadıysanız Go'u indirip yükleyin.
İşletim sisteminiz için Go sürümünü indirin.
İndirme işlemi tamamlandıktan sonra yükleyiciyi çalıştırın.
Bir komut istemi açın ve Go'nun yüklendiğini onaylamak için aşağıdakileri girin:
go version
Depolama kapsayıcısında tüm belgeleri çevirme
Konsol penceresinde (cmd, PowerShell veya Bash gibi), uygulamanız için document-translation-qs adlı yeni bir dizin oluşturun ve bu dizine gidin.
document-translation-qs dizininde document-translation.go adlı yeni bir Go dosyası oluşturun.
Belge çevirisi kodu örneğini kopyalayıp document-translation.go dosyanıza yapıştırın.
Azure portal Çeviri örneğinizdeki değerlerle ve
{your-key}
değerlerini güncelleştirin{your-document-translation-endpoint}
.ve
{your-target-container-SAS-URL}
değerini{your-source-container-SAS-URL}
Azure portal Depolama hesap kapsayıcıları örneğinizdeki değerlerle güncelleştirin.
Kod örneği
Önemli
İşiniz bittiğinde anahtarı kodunuzdan kaldırmayı unutmayın ve asla herkese açık olarak göndermeyin. Üretim için Azure Key Vault gibi kimlik bilgilerinizi depolamanın ve bunlara erişmenin güvenli bir yolunu kullanın. Daha fazla bilgi için bkz. Azure AI hizmetleri güvenliği.
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)
}
Go uygulamanızı çalıştırma
Uygulamanıza bir kod örneği ekledikten sonra Go programınız bir komut veya terminal isteminde yürütülebilir. İsteminizin yolunun document-translation-qs klasörüne ayarlandığından emin olun ve aşağıdaki komutu kullanın:
go run document-translation.go
Başarıyla tamamlandıktan sonra:
- Çevrilen belgeler hedef kapsayıcınızda bulunabilir.
- Başarılı POST yöntemi, hizmetin toplu iş isteğini oluşturduğunu belirten bir
202 Accepted
yanıt kodu döndürür. - POST isteği, sonraki GET isteklerinde kullanılan bir değer sağlayan yanıt üst bilgilerini
Operation-Location
de döndürür.
Java ortamınızı ayarlama
Bu hızlı başlangıçta, uygulamayı oluşturmak ve çalıştırmak için Gradle derleme otomasyon aracını kullanırız.
Visual Studio Code'un en son sürümüne veya tercih ettiğiniz IDE'ye sahip olmanız gerekir. Bkz.Visual Studio Code'da Java.
İpucu
- Visual Studio Code, Windows ve macOS için Java için bir Kodlama Paketi sunar.Kodlama paketi, BIR VS Code paketi, Java Geliştirme Seti (JDK) ve Microsoft tarafından önerilen uzantılardan oluşan bir koleksiyondur. Kodlama Paketi, mevcut geliştirme ortamını düzeltmek için de kullanılabilir.
- VS Code ve Java için Kodlama Paketi kullanıyorsanız Java için Gradle uzantısını yükleyin.
Visual Studio Code kullanmıyorsanız, geliştirme ortamınızda aşağıdakilerin yüklü olduğundan emin olun:
Java Geliştirme Seti (OpenJDK) sürüm 8 veya üzeri.
Gradle, sürüm 6.8 veya üzeri.
Yeni Gradle projesi oluşturma
Konsol penceresinde (cmd, PowerShell veya Bash gibi), uygulamanız için belge çevirisi adlı yeni bir dizin oluşturun ve bu dizine gidin.
mkdir document-translation && document-translation
mkdir document-translation; cd document-translation
Belge çevirisi
gradle init
dizininden komutunu çalıştırın. Bu komut, uygulamanızı oluşturmak ve yapılandırmak için çalışma zamanında kullanılan build.gradle.kts dahil olmak üzere Gradle için temel derleme dosyaları oluşturur.gradle init --type basic
DSL seçmeniz istendiğinde Kotlin'i seçin.
İade veya Enter'ı seçerek varsayılan proje adını (belge çevirisi) kabul edin.
Not
Uygulamanın tamamının oluşturulması birkaç dakika sürebilir, ancak yakında dahil olmak üzere
build-gradle.kts
birkaç klasör ve dosya görmeniz gerekir.Aşağıdaki kodla güncelleştirin
build.gradle.kts
:
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")
}
Depolama kapsayıcısında tüm belgeleri çevirme
Belge çevirisi dizininden aşağıdaki komutu çalıştırın:
mkdir -p src/main/java
komutu aşağıdaki dizin yapısını oluşturur:
dizinine
java
gidin ve adlıDocumentTranslation.java
bir dosya oluşturun.İpucu
PowerShell kullanarak yeni bir dosya oluşturabilirsiniz.
Shift tuşunu basılı tutarak ve klasöre sağ tıklayarak proje dizininizde bir PowerShell penceresi açın.
Yeni Öğe DocumentTranslation.java aşağıdaki komutu girin.
Ayrıca, IDE'nizde adlı
DocumentTranslation.java
yeni bir dosya oluşturabilir ve bunu dizinejava
kaydedebilirsiniz.
Belge çevirisi kodu örneğini kopyalayıp DocumentTranslation.java dosyanıza yapıştırın.
Azure portal Çeviri örneğinizdeki değerlerle ve
{your-key}
değerlerini güncelleştirin{your-document-translation-endpoint}
.ve
{your-target-container-SAS-URL}
değerini{your-source-container-SAS-URL}
Azure portal Depolama hesap kapsayıcıları örneğinizdeki değerlerle güncelleştirin.
Kod örneği
Önemli
İşiniz bittiğinde anahtarı kodunuzdan kaldırmayı unutmayın ve asla herkese açık olarak göndermeyin. Üretim için Azure Key Vault gibi kimlik bilgilerinizi depolamanın ve bunlara erişmenin güvenli bir yolunu kullanın. Daha fazla bilgi için bkz . Azure AI hizmetleri güvenliği.
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);
}
}
}
Java uygulamanızı derleme ve çalıştırma
Uygulamanıza bir kod örneği ekledikten sonra ana proje dizininize( belge çevirisi) geri gidin, bir konsol penceresi açın ve aşağıdaki komutları girin:
Uygulamanızı şu komutla
build
oluşturun:gradle build
Uygulamanızı şu komutla
run
çalıştırın:gradle run
Başarıyla tamamlandıktan sonra:
- Çevrilen belgeler hedef kapsayıcınızda bulunabilir.
- Başarılı POST yöntemi, hizmetin toplu iş isteğini oluşturduğunu belirten bir
202 Accepted
yanıt kodu döndürür. - POST isteği, sonraki GET isteklerinde kullanılan bir değer sağlayan yanıt üst bilgilerini
Operation-Location
de döndürür.
Node.js ortamınızı ayarlama
Bu hızlı başlangıçta, uygulamayı oluşturmak ve çalıştırmak için Node.js JavaScript çalışma zamanı ortamını kullanacağız.
Henüz yapmadıysanız Node.js'nin en son sürümünü yükleyin. Düğüm Paket Yöneticisi (npm) Node.js yüklemesine dahil edilir.
İpucu
Node.js'yi yeni kullanıyorsanız Node.js Learn'e Giriş modülünü deneyin.
Konsol penceresinde (cmd, PowerShell veya Bash gibi), uygulamanız için adlı
document-translation
yeni bir dizin oluşturun ve bu dizine gidin.mkdir document-translation && cd document-translation
mkdir document-translation; cd document-translation
Uygulamayı başlatmak ve projenizin iskelesini yapmak için npm init komutunu çalıştırın.
npm init
Terminalde sunulan istemleri kabul ederek projenizin özniteliklerini belirtin.
- En önemli öznitelikler ad, sürüm numarası ve giriş noktasıdır.
- Giriş noktası adı için saklamanızı
index.js
öneririz. Açıklama, test komutu, GitHub deposu, anahtar sözcükler, yazar ve lisans bilgileri isteğe bağlı özniteliklerdir; bunlar bu proje için atlanabilir. - İade veya Enter'ı seçerek önerileri parantez içinde kabul edin.
- İstemleri tamamladıktan sonra, belge çevirisi dizininizde bir
package.json
dosya oluşturulur.
HTTP kitaplığını
axios
veuuid
paketini belge çevirisi uygulama dizininize yüklemek için npm kullanın:npm install axios uuid
Depolama kapsayıcısında tüm belgeleri çevirme
index.js
Dosyayı uygulama dizininde oluşturun.İpucu
PowerShell kullanarak yeni bir dosya oluşturabilirsiniz.
Shift tuşunu basılı tutarak ve klasöre sağ tıklayarak proje dizininizde bir PowerShell penceresi açın.
Yeni Öğe index.js aşağıdaki komutu girin.
Ayrıca, IDE'nizde adlı
index.js
yeni bir dosya oluşturabilir ve bunu dizinedocument-translation
kaydedebilirsiniz.
Belge çevirisi kodu örneğini kopyalayıp dosyanıza
index.js
yapıştırın.Azure portal Çeviri örneğinizdeki değerlerle ve
{your-key}
değerlerini güncelleştirin{your-document-translation-endpoint}
.ve
{your-target-container-SAS-URL}
değerini{your-source-container-SAS-URL}
Azure portal Depolama hesap kapsayıcıları örneğinizdeki değerlerle güncelleştirin.
Kod örneği
Önemli
İşiniz bittiğinde anahtarı kodunuzdan kaldırmayı unutmayın ve asla herkese açık olarak göndermeyin. Üretim için Azure Key Vault gibi kimlik bilgilerinizi depolamanın ve bunlara erişmenin güvenli bir yolunu kullanın. Daha fazla bilgi için bkz. Azure AI hizmetleri güvenliği.
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);
});
JavaScript uygulamanızı çalıştırma
Kod örneğini uygulamanıza ekledikten sonra programınızı çalıştırın:
Uygulama dizininize (belge çevirisi) gidin.
Terminalinizde aşağıdaki komutu girin ve çalıştırın:
node index.js
Başarıyla tamamlandıktan sonra:
- Çevrilen belgeler hedef kapsayıcınızda bulunabilir.
- Başarılı POST yöntemi, hizmetin toplu iş isteğini oluşturduğunu belirten bir
202 Accepted
yanıt kodu döndürür. - POST isteği, sonraki GET isteklerinde kullanılan bir değer sağlayan yanıt üst bilgilerini
Operation-Location
de döndürür.
Python projenizi ayarlama
Henüz yapmadıysanız Python 3.x'in en son sürümünü yükleyin. Python yükleyici paketi (pip) Python yüklemesine dahil edilir.
İpucu
Python'da yeniyseniz Python Learn'e Giriş modülünü deneyin.
Bir terminal penceresi açın ve İstekler kitaplığını ve uuid0 paketini yüklemek için pip kullanın:
pip install requests uuid
Depolama kapsayıcısında tüm belgeleri çevirme
Tercih ettiğiniz düzenleyiciyi veya IDE'yi kullanarak uygulamanız için adlı
document-translation
yeni bir dizin oluşturun.Belge çevirisi dizininizde document-translation.py adlı yeni bir Python dosyası oluşturun.
Belge çevirisi kodu örneğini kopyalayıp dosyanıza
document-translation.py
yapıştırın.Azure portal Çeviri örneğinizdeki değerlerle ve
{your-key}
değerlerini güncelleştirin{your-document-translation-endpoint}
.ve
{your-target-container-SAS-URL}
değerini{your-source-container-SAS-URL}
Azure portal Depolama hesap kapsayıcıları örneğinizdeki değerlerle güncelleştirin.
Kod örneği
Önemli
İşiniz bittiğinde anahtarı kodunuzdan kaldırmayı unutmayın ve asla herkese açık olarak göndermeyin. Üretim için Azure Key Vault gibi kimlik bilgilerinizi depolamanın ve bunlara erişmenin güvenli bir yolunu kullanın. Daha fazla bilgi için bkz . Azure AI hizmetleri güvenliği.
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)
Python uygulamanızı çalıştırma
Uygulamanıza bir kod örneği ekledikten sonra programınızı derleyip çalıştırın:
Belge çevirisi dizininize gidin.
Konsolunuzda aşağıdaki komutu girin ve çalıştırın:
python document-translation.py
Başarıyla tamamlandıktan sonra:
- Çevrilen belgeler hedef kapsayıcınızda bulunabilir.
- Başarılı POST yöntemi, hizmetin toplu iş isteğini oluşturduğunu belirten bir
202 Accepted
yanıt kodu döndürür. - POST isteği, sonraki GET isteklerinde kullanılan bir değer sağlayan yanıt üst bilgilerini
Operation-Location
de döndürür.
Programlama ortamınızı ayarlama
Bu hızlı başlangıçta, Belge Çevirisi REST API çağrıları yapmak için cURL komut satırı aracını kullanacağız.
Not
cURL paketi çoğu Windows 10 ve Windows 11'e ve çoğu macOS ve Linux dağıtımına önceden yüklenmiştir. Paket sürümünü şu komutlarla de kontrol edebilirsiniz: Windows: curl.exe -V
.
macOS curl -V
Linux: curl --version
cURL yüklü değilse, platformunuzun bağlantıları şunlardır:
Belgeleri çevirme (POST İsteği)
Tercih ettiğiniz düzenleyiciyi veya IDE'yi kullanarak uygulamanız için adlı
document-translation
yeni bir dizin oluşturun.Belge çevirisi dizininizde document-translation.json adlı yeni bir json dosyası oluşturun.
Belge çevirisi isteği örneğini kopyalayıp dosyanıza
document-translation.json
yapıştırın. ve{your-target-container-SAS-URL}
değerlerini Azure portal Depolama hesap kapsayıcıları örneğinizdeki değerlerle değiştirin{your-source-container-SAS-URL}
.İstek örneği:
{ "inputs":[ { "source":{ "sourceUrl":"{your-source-container-SAS-URL}" }, "targets":[ { "targetUrl":"{your-target-container-SAS-URL}", "language":"fr" } ] } ] }
POST isteğini derleme ve çalıştırma
POST isteğini çalıştırmadan önce ve {your-key}
değerini Azure portal Çeviri örneğinizdeki değerlerle değiştirin{your-document-translator-endpoint}
.
Önemli
İşiniz bittiğinde anahtarı kodunuzdan kaldırmayı unutmayın ve asla herkese açık olarak göndermeyin. Üretim için Azure Key Vault gibi kimlik bilgilerinizi depolamanın ve bunlara erişmenin güvenli bir yolunu kullanın. Daha fazla bilgi için bkz . Azure AI hizmetleri güvenliği.
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"
komut istemi / 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"
Başarıyla tamamlandıktan sonra:
- Çevrilen belgeler hedef kapsayıcınızda bulunabilir.
- Başarılı POST yöntemi, hizmetin toplu iş isteğini oluşturduğunu belirten bir
202 Accepted
yanıt kodu döndürür. - POST isteği, sonraki GET isteklerinde kullanılan bir değer sağlayan yanıt üst bilgilerini
Operation-Location
de döndürür.
İşte bu kadar, tebrikler! Bu hızlı başlangıçta, belgenin özgün yapısını ve veri biçimini koruyarak belgeyi çevirmek için Belge Çevirisi kullandınız.