Hızlı Başlangıç: Azure AI Translator metin istemcisi kitaplıkları

2025-05-19

Bu hızlı başlangıçta, istediğiniz programlama dilini kullanarak metin çevirmek için Translator hizmetini kullanmaya başlayın. Bu proje için, teknolojiyi öğrenirken ücretsiz fiyatlandırma katmanını (F0) kullanmanızı ve daha sonra üretim için ücretli bir katmana yükseltmenizi öneririz.

Önkoşullar

Etkin bir Azure aboneliğine ihtiyacınız vardır. Azure aboneliğiniz yoksa ücretsiz bir abonelik oluşturabilirsiniz

Azure aboneliğinizi aldıktan sonra Azure portalında bir Translator kaynağı oluşturun.
Kaynağınız dağıtıldıktan sonra Kaynağa Git'i seçin ve anahtar ile uç nokta bilgilerinizi alın.
- Kaynaktan anahtarı, uç noktayı ve bölgeyi alın ve uygulamanızı Translator hizmetine bağlayın. Bu değerleri hızlı başlangıcın ilerleyen bölümlerinde koda yapıştırın. Bunları Azure portalı Anahtarlar ve Uç Nokta sayfasında bulabilirsiniz:

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 başlatı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 girintext-translation-sdk. Ardından İleriseçin.
Ek bilgiler iletişim kutusunda .NET 6.0 (uzun süreli destek) öğesini ve ardından Oluştur'u seçin.

NuGet ile istemci kitaplığını yükleme

Translator-text-sdk projenize sağ tıklayın ve Visual Studio'da NuGet paketi seçme penceresinin ekran görüntüsü'nü seçin Manage NuGet Packages...
Browse Sekmesini ve Include prerelease onay kutusunu seçin ve Azure.AI.Translation.Text yazın.
Açılan menüden sürümü 1.0.0-beta.1 seçin ve paketi projenize yükleyin.

Uygulamanızı oluşturun

İstemci kitaplığını kullanarak Translator hizmetiyle etkileşim kurmak için sınıfının bir örneğini TextTranslationClientoluşturmanız gerekir. Bunu yapmak için, Azure portalından alınan AzureKeyCredential ile bir key oluşturun ve TextTranslationClient ile bir AzureKeyCredential örneği oluşturun. Kimlik doğrulaması, kaynağınızın bölgesel veya genel uç noktayı kullanıp kullanmadığına bağlı olarak biraz değişir. Bu proje için genel uç noktayı kullanarak kimlik doğrulamasından geçin. Bölgesel bir uç nokta kullanımıyla ilgili daha fazla bilgi için bkz:Translator metin SDK'ları.

Uyarı

.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 Main yönteminin gövdesini yazmanız gerekir. Üst düzey deyimleri, genel using yönergelerini veya örtük using yönergelerini eklemeniz gerekmez.
Daha fazla bilgi için, bakınızYeni C# şablonları üst düzey deyimler oluşturur.

Program.cs dosyasını açın.
satırı Console.WriteLine("Hello World!")da dahil olmak üzere mevcut kodu silin ve uygulamanızın Program.cs dosyasına aşağıdaki kod örneğini girin:

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.

Metin çevirme

Uyarı

Bu örnekte genel uç noktayı kullanıyoruz. Bölgesel uç nokta kullanıyorsanız bkz. Metin çevirisi istemcisi oluşturma.


using Azure;
using Azure.AI.Translation.Text;


string key = "<your-key>";

AzureKeyCredential credential = new(key);
TextTranslationClient client = new(credential);

try
{
    string targetLanguage = "fr";
    string inputText = "This is a test.";

    Response<IReadOnlyList<TranslatedTextItem>> response = await client.TranslateAsync(targetLanguage, inputText).ConfigureAwait(false);
    IReadOnlyList<TranslatedTextItem> translations = response.Value;
    TranslatedTextItem translation = translations.FirstOrDefault();

    Console.WriteLine($"Detected languages of the input text: {translation?.DetectedLanguage?.Language} with score: {translation?.DetectedLanguage?.Score}.");
    Console.WriteLine($"Text was translated to: '{translation?.Translations?.FirstOrDefault().To}' and the result is: '{translation?.Translations?.FirstOrDefault()?.Text}'.");
}
catch (RequestFailedException exception)
{
    Console.WriteLine($"Error Code: {exception.ErrorCode}");
    Console.WriteLine($"Message: {exception.Message}");
}

Uygulamanızı çalıştırma

Kod örneğini uygulamanıza ekledikten sonra, programınızı oluşturmak ve çalıştırmak için formRecognizer_quickstart yanındaki yeşil Başlangıç düğmesini seçin veya F5 tuşuna basın.

Ekran görüntüsü: Visual Studio programınızı çalıştırın.

Beklenen çıkışın kod parçacığı aşağıdadır:

Terminal penceresindeki Visual Studio Code çıkışının ekran görüntüsü.

Java ortamınızı ayarlama

Uyarı

Java için Azure Metin Çevirisi SDK'sı Windows, Linux ve macOS platformlarında test edilir ve desteklenir. Diğer platformlarda test değildir ve Android dağıtımlarını desteklemez.

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.
Tavsiye
- 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 text-translation-app adlı yeni bir dizin oluşturun ve bu dizine gidin.
```
mkdir text-translation-app && text-translation-app
```
```
mkdir text-translation-app; cd text-translation-app
```
gradle init text-translation-app 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ı (text-translation-app) kabul edin.

Uyarı

Uygulamanın tamamının oluşturulması birkaç dakika sürebilir, ancak yakında build-gradle.kts gibi birkaç klasör ve dosya görmeniz gerekir.

Aşağıdaki kodla güncelleştirin build.gradle.kts . Ana sınıf Translate'tir:

  plugins {
  java
  application
}
application {
  mainClass.set("Translate")
}
repositories {
  mavenCentral()
}
dependencies {
  implementation("com.azure:azure-ai-translation-text:1.0.0-beta.1")
}

Java uygulamanızı oluşturma

text-translation-app 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ı Translate.javabir dosya oluşturun.
Tavsiye
- 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.
- Aşağıdaki komutu New-Item Translate.java girin.
- Ayrıca, IDE'nizde adlı Translate.java yeni bir dosya oluşturabilir ve bunu dizine java kaydedebilirsiniz.
Aşağıdaki metin çevirisi kodu örneğini kopyalayıp Translate.java dosyanıza yapıştırın.
- "<your-key>", "<your-endpoint>" ve "<region>" değerlerini Azure portal Translator örneğinizdeki değerlerle güncelleştirin.

Kod örneği

Metin çevirme

Önemli

Uyarı

Bu örnekte genel uç noktayı kullanıyoruz. Bölgesel uç nokta kullanıyorsanız bkz. Metin çevirisi istemcisi oluşturma.

import java.util.List;
import java.util.ArrayList;
import com.azure.ai.translation.text.models.*;
import com.azure.ai.translation.text.TextTranslationClientBuilder;
import com.azure.ai.translation.text.TextTranslationClient;

import com.azure.core.credential.AzureKeyCredential;
/**
 * Translate text from known source language to target language.
 */
public class Translate {

    public static void main(String[] args) {
        String apiKey = "<your-key>";
        AzureKeyCredential credential = new AzureKeyCredential(apiKey);

        TextTranslationClient client = new TextTranslationClientBuilder()
                .credential(credential)
                .buildClient();

        String from = "en";
        List<String> targetLanguages = new ArrayList<>();
        targetLanguages.add("es");
        List<InputTextItem> content = new ArrayList<>();
        content.add(new InputTextItem("This is a test."));

        List<TranslatedTextItem> translations = client.translate(targetLanguages, content, null, from, TextType.PLAIN, null, null, null, false, false, null, null, null, false);

        for (TranslatedTextItem translation : translations) {
            for (Translation textTranslation : translation.getTranslations()) {
                System.out.println("Text was translated to: '" + textTranslation.getTo() + "' and the result is: '" + textTranslation.getText() + "'.");
            }
        }
    }
}

Uygulamayı derleme ve çalıştırma**

Kod örneğini uygulamanıza ekledikten sonra ana proje dizininize (metin çevirisi-uygulaması) geri gidin.

build komutunu kullanarak uygulamanızı inşa edin ( BUILD SUCCESSFUL mesajını almalısınız):
```
gradle build
```
Uygulamanızı komutuyla run çalıştırın ( BUILD SUCCESSFUL iletisi almalısınız):
```
gradle run
```

Beklenen çıkışın kod parçacığı aşağıdadır:

Terminal penceresindeki Java çıkışının ekran görüntüsü.

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.

en sonNode.jssürümüne sahip olduğunuzdan emin olun. Düğüm Paket Yöneticisi (npm) Node.js yüklemesine dahil edilir.

Tavsiye

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ı text-translation-appyeni bir dizin oluşturun ve bu dizine gidin.
```
mkdir text-translation-app && cd text-translation-app
```
```
mkdir text-translation-app; cd text-translation-app
```
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 index.js saklamanızı ö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.
- Parantez içerisindeki önerileri kabul etmek için Return veya Enter'ı seçin.
- İstemleri tamamladıktan sonra text-translation-app dizininizde bir package.json dosya oluşturulur.

İstemci kitaplığını yükleme

Bir terminal penceresi açın ve Azure Text translation ile JavaScript için npm istemci kitaplığını yükleyin.

npm i @azure-rest/ai-translation-text@1.0.0-beta.1

Uygulamanızı oluşturun

İstemci kitaplığını kullanarak Translator hizmetiyle etkileşim kurmak için sınıfının bir örneğini TextTranslationClientoluşturmanız gerekir. Bunu yapmak için Azure portalından ve bir TranslateCredential örneğinden key ve <region> ile bir TextTranslationClient oluşturun. Daha fazla bilgi için bkz Translator metin SDK'leri.

index.js Dosyayı uygulama dizininde oluşturun.
Tavsiye
- 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.
- New-Item index.jsaşağıdaki komutu girin.
- Ayrıca, IDE'nizde adlı index.js yeni bir dosya oluşturabilir ve bunu dizine text-translation-app kaydedebilirsiniz.
Aşağıdaki metin çevirisi kodu örneğini kopyalayıp dosyanıza index.js yapıştırın. Azure portal Translator örneğinizden değerlerle <your-endpoint> ve <your-key>'i güncelleyin.

Kod örneği

Önemli

Metin çevirme

Uyarı

Bu örnekte bölgesel bir uç nokta kullanıyoruz. Genel uç noktayı kullanıyorsanız bkz. Metin çevirisi istemcisi oluşturma.

const TextTranslationClient = require("@azure-rest/ai-translation-text").default

const apiKey = "<your-key>";
const endpoint = "<your-endpoint>";
const region = "<region>";

async function main() {

  console.log("== Text translation sample ==");

  const translateCredential = {
    key: apiKey,
    region,
  };
  const translationClient = new TextTranslationClient(endpoint,translateCredential);

  const inputText = [{ text: "This is a test." }];
  const translateResponse = await translationClient.path("/translate").post({
    body: inputText,
    queryParameters: {
      to: "fr",
      from: "en",
    },
  });

  const translations = translateResponse.body;
  for (const translation of translations) {
    console.log(
      `Text was translated to: '${translation?.translations[0]?.to}' and the result is: '${translation?.translations[0]?.text}'.`
    );
  }
}

main().catch((err) => {
    console.error("An error occurred:", err);
    process.exit(1);
  });

  module.exports = { main };

Uygulamanızı çalıştırma

Kod örneğini uygulamanıza ekledikten sonra programınızı çalıştırın:

Metin çevirisi uygulamanızın (metin çevirisi-uygulaması) bulunduğu klasöre gidin.
Terminalinize aşağıdaki komutu yazın:
```
node index.js
```

Beklenen çıkışın kod parçacığı aşağıdadır:

Terminal penceresinde JavaScript çıktısının ekran görüntüsü.

Python projenizi ayarlama

Python 3.x'in en son sürümüne sahip olduğunuzdan emin olun. Python yükleyici paketi (pip) Python yüklemesine dahil edilir.

Tavsiye

Python'da yeniyseniz Python Learn'e Giriş modülünü deneyin.
Bir terminal penceresi açın ve Python için Azure Text translation istemci kitaplığını pip ile yükleyin.
```
pip install azure-ai-translation-text==1.0.0b1
```

Uygulamanızı oluşturun

İstemci kitaplığını kullanarak Translator hizmetiyle etkileşim kurmak için sınıfının bir örneğini TextTranslationClientoluşturmanız gerekir. Azure portalından aldığınız TranslatorCredential ile bir key örneği oluşturmak için TextTranslationClient kullanın. Daha fazla bilgi için bkz Translator metin SDK'leri.

Tercih ettiğiniz düzenleyicide veya IDE'de text-translation-app.py adlı yeni bir Python dosyası oluşturun.
Aşağıdaki metin çevirisi kodu örnek kod örneğini kopyalayıp text-translation-app.py dosyasına yapıştırın. <your-key>, <your-endpoint> ve <region> değerlerini Azure portal Translator örneğinizdeki değerlerle güncelleyin.

Kod örneği

Önemli

Metin çevirme

Uyarı

Bu örnekte bölgesel bir uç nokta kullanıyoruz. Genel uç noktayı kullanıyorsanız bkz. Metin çevirisi istemcisi oluşturma.

from azure.ai.translation.text import TextTranslationClient, TranslatorCredential
from azure.ai.translation.text.models import InputTextItem
from azure.core.exceptions import HttpResponseError

# set `<your-key>`, `<your-endpoint>`, and  `<region>` variables with the values from the Azure portal
key = "<your-key>"
endpoint = "<your-endpoint>"
region = "<region>"

credential = TranslatorCredential(key, region)
text_translator = TextTranslationClient(endpoint=endpoint, credential=credential)

try:
    source_language = "en"
    target_languages = ["es", "it"]
    input_text_elements = [ InputTextItem(text = "This is a test") ]

    response = text_translator.translate(content = input_text_elements, to = target_languages, from_parameter = source_language)
    translation = response[0] if response else None

    if translation:
        for translated_text in translation.translations:
            print(f"Text was translated to: '{translated_text.to}' and the result is: '{translated_text.text}'.")

except HttpResponseError as exception:
    print(f"Error Code: {exception.error.code}")
    print(f"Message: {exception.error.message}")

Uygulamayı çalıştırma

Kod örneğini uygulamanıza ekledikten sonra programınızı derleyip çalıştırın:

text-translation-app.py dosyanızın bulunduğu klasöre gidin.

Terminalinize aşağıdaki komutu yazın:

python text-translation-app.py

Beklenen çıkışın kod parçacığı aşağıdadır:

Terminal penceresinde JavaScript çıktısının ekran görüntüsü.

İşte bu kadar, tebrikler! Bu hızlı başlangıçta, metni çevirmek için metin çevirisi SDK'sını kullandınız.

Sonraki adımlar

Metin çevirisi geliştirme seçenekleri hakkında daha fazla bilgi edinin:

Metin çevirisi SDK'sı genel bakış

Metin çevirisi V3 başvurusu

Aracılığıyla paylaş

Hızlı Başlangıç: Azure AI Translator metin istemcisi kitaplıkları

Önkoşullar

C#/.NET ortamınızı ayarlama

NuGet ile istemci kitaplığını yükleme

Uygulamanızı oluşturun

Kod örneği

Uygulamanızı çalıştırma

Java ortamınızı ayarlama

Yeni Gradle projesi oluşturma

Java uygulamanızı oluşturma

Kod örneği

Uygulamayı derleme ve çalıştırma**

Node.js ortamınızı ayarlama

İstemci kitaplığını yükleme

Uygulamanızı oluşturun

Kod örneği

Uygulamanızı çalıştırma

Python projenizi ayarlama

Uygulamanızı oluşturun

Kod örneği

Uygulamayı çalıştırma

Sonraki adımlar

Geri Bildirim

Ek kaynaklar