Пакет SDK для перевода текста Azure

2025-05-28

Перевод текста Azure — это облачная функция REST API службы Azure AI Translator. API перевода текста обеспечивает быстрый и точный перевод текста с одного языка на другой в режиме реального времени. Пакет средств разработки программного обеспечения для перевода текста (SDK) — это набор библиотек и инструментов, которые позволяют легко интегрировать возможности REST API перевода текста в приложения. Пакет SDK для перевода текста доступен на разных платформах программирования на C#/.NET, Java, JavaScript и Python.

Поддерживаемые языки

Пакет SDK для перевода текста поддерживает языки программирования и платформы:

Язык → версия пакета SDK	Пакет	Клиентская библиотека	Поддерживаемая версия API
.NET/C# → 1.0.0	NuGet	Пакет Azure SDK для .NET	Переводчик версии 3.0
Java✱ → 1.0.0	Репозиторий Maven	Пакет Azure SDK для Java	Переводчик версии 3.0
JavaScript → 1.0.0	npm	Пакет SDK для Azure для JavaScript	Переводчик версии 3.0
Python → 1.0.1	PyPi	Пакет SDK для Azure для Python	Переводчик версии 3.0

✱ Пакет SDK для перевода текстов Azure для Java тестируется и поддерживается на платформах Windows, Linux и macOS. Он не тестируется на других платформах и не поддерживает развертывания Android.

Журнал изменений и история выпусков

В этом разделе представлено описание функций перевода текста и возможностей, а также изменений, обновлений и улучшений в зависимости от версии.

Выпуск пакета SDK для перевода текста в общую доступность в мае 2024 г.

Этот выпуск включает в себя следующие обновления.

Версия 1.0.0 (2024-05-21)
Перевод текста Targets v3.0
Выпуск общедоступной версии

Пакет (NuGet)

Журнал изменений и выпусков

README

Примеры

Предварительный выпуск пакета SDK для перевода текстов за апрель 2023 г.

Этот выпуск включает в себя следующие обновления.

Версия 1.0.0-beta.1 (2023-04-17)
Перевод текста Targets v3.0
Выпуск начальной версии

Пакет (NuGet)

Журнал изменений и выпусков

README

Примеры

Использование пакета SDK перевода текста в приложениях

Пакет SDK для перевода текста позволяет использовать и управлять службой перевода текста в приложении. Пакет SDK основан на базовом REST API перевода текстов, что позволяет легко использовать эти API в парадигме языка программирования. Вот как вы используете пакет SDK для перевода текста для предпочитаемого языка программирования:

1. Установите клиентскую библиотеку.

dotnet add package Azure.AI.Translation.Text --version 1.0.0-beta.1

Install-Package Azure.AI.Translation.Text -Version 1.0.0-beta.1

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-ai-translation-text</artifactId>
    <version>1.0.0-beta.1</version>
</dependency>

implementation("com.azure:azure-ai-translation-text:1.0.0-beta.1")

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

pip install azure-ai-translation-text==1.0.0b1

2. Импортируйте клиентскую библиотеку пакета SDK в приложение.

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

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;

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

from azure.core.credentials import AzureKeyCredential
from azure.ai.translation.text import TextTranslationClient

3. Проверка подлинности клиента

Взаимодействие со службой Переводчика с помощью клиентской библиотеки начинается с создания экземпляра TextTranslationClientкласса. Для создания экземпляра клиентского объекта требуется ключ API и регион. Ключ API перевода текста найден на портале Azure:

Снимок экрана: расположение ключей и конечной точки на портале Azure.

Использование глобальной конечной точки (по умолчанию)

string key = "<your-key>";

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

Использование региональной конечной точки


Uri endpoint = new("<your-endpoint>");
string key = "<your-key>";
string region = "<region>";

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

Использование глобальной конечной точки (по умолчанию)


String apiKey = "<your-key>";
AzureKeyCredential credential = new AzureKeyCredential(apiKey);

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

Использование региональной конечной точки

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

AzureKeyCredential credential = new AzureKeyCredential(apiKey);

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


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

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


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

key = "<your-key>"
endpoint = "<your-endpoint>"
region = "<region>"


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

4. Выполните сборку приложения.

Создайте клиентский объект для взаимодействия с пакетом SDK перевода текста, а затем вызовите методы для этого клиентского объекта для взаимодействия со службой. Пакеты SDK предоставляют синхронные и асинхронные методы. Дополнительные сведения см в репозитории примеров перевода текста для .NET/C#.

Опции помощи

Форумы Microsoft Q & A и Stack Overflow доступны для сообщества разработчиков, чтобы задавать и отвечать на вопросы о переводе текста Azure и других платформах. Корпорация Майкрософт отслеживает форумы и отвечает на вопросы, на которые сообщество пока не ответило. Чтобы убедиться, что ваш вопрос отображается, пометьте его тегом azure-text-translation.

Дальнейшие шаги

Краткое руководство по переводу текста

Справочник по переводу текста версии 3.0