Kit de développement logiciel (SDK) de traduction de texte Azure (préversion)

Article
01/11/2024

Important

Les SDK de traduction de texte Translator Text sont actuellement disponibles en préversion publique. Les fonctionnalités, les approches et les processus peuvent changer, avant la disponibilité générale (GA), en fonction des commentaires des utilisateurs.

La traduction de texte Azure est une fonctionnalité d’API REST basée sur le cloud du service AI Azure Translator. L’API Traduction de texte permet des traductions de texte de source à cible rapides et précises en temps réel. Le kit de développement logiciel (SDK) Traduction de texte est un ensemble de bibliothèques et d’outils qui vous permettent d’intégrer facilement les fonctionnalités de l’API REST Traduction de texte dans vos applications. Le kit de développement logiciel (SDK) Traduction de texte est disponible sur les plateformes de programmation en C#/.NET, Java, JavaScript et Python.

Langues prises en charge

Le Kit de développement logiciel (SDK) de traduction de texte prend en charge les langages de programmation et les plateformes :

Langage → Version SDK	Paquet	Bibliothèque cliente	Version de l’API prise en charge
.NET/C# → 1.0.0-beta.1	NuGet	Kit de développement logiciel (SDK) Azure pour .NET	Translator v3.0
Java✱ → 1.0.0-beta.1	Référentiel MNV	Kit de développement logiciel (SDK) Azure pour Java	Translator v3.0
JavaScript → 1.0.0-beta.1	npm	Kit de développement logiciel (SDK) pour JavaScript	Translator v3.0
Python → 1.0.0b1	PyPI	Kit de développement logiciel (SDK) Azure pour Python	Translator v3.0

✱ Le Kit de développement logiciel (SDK) de traduction de texte Azure pour Java est testé et pris en charge par les plateformes Windows, Linux et macOS. Il n'est pas testé sur d'autres plateformes et ne prend pas en charge les déploiements Android.

Journal des modifications et historique des versions

Cet article de référence fournit une description, basée sur la version, des fonctionnalités, des capacités de la version, des modifications, des améliorations et des mises à jour de Traduction de texte.

Version préliminaire d’avril 2023 du kit de développement logiciel (SDK) Traduction de texte Translator Text

Cette version inclut les mises à jour suivantes :

Utiliser le kit de développement logiciel (SDK) Traduction de texte dans vos applications

Le kit de développement logiciel (SDK) Traduction de texte permet d’utiliser et de gérer le service Traduction de texte dans votre application. Le SDK s’appuie sur l’API REST sous-jacente de Text Translation, ce qui vous permet d’utiliser facilement ces API dans le paradigme de votre langage de programmation. Voici comment utiliser le SDK Traduction de texte avec votre langage de programmation préféré :

1. Installez la bibliothèque de client du SDK

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. Importez la bibliothèque de client du SDK dans votre application

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 TextTranslationClient
from azure-ai-translation-text import TextTranslationClient

3. Authentifier le client

L’interaction avec le service Translator à l’aide de la bibliothèque de client commence par la création d’une instance de la classeTextTranslationClient. Vous avez besoin de votre clé API et de votre région pour instancier un objet client. La clé API Traduction de texte se trouve dans le portail Azure :

Screenshot of the keys and endpoint location in the Azure portal.

À l’aide du point de terminaison global (par défaut)

string key = "<your-key>";

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

À l’aide d’un point de terminaison régional


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

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

À l’aide du point de terminaison global (par défaut)


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

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

À l’aide d’un point de terminaison régional

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. Générez votre application

Créez un objet client pour interagir avec le kit de développement logiciel (SDK) Traduction de texte, puis appeler des méthodes sur cet objet client pour interagir avec le service. Les SDK fournissent des méthodes synchrones et asynchrones. Pour plus d’informations, consultez le référentiel d’exemple de Traduction de texte pour .NET/C#.

Options d’aide

Les forums Microsoft Q&A et Stack Overflow sont à disposition de la communauté de développeurs pour poser des questions sur Traduction de texte Azure et autres services, et y répondre. Microsoft surveille les forums et répond aux questions auxquelles la communauté n’a pas encore répondu. Pour nous permettre de voir votre question, attribuez-lui l’étiquette azure-text-translation.

Étapes suivantes

Démarrage rapide de Traduction de texte

Guide de référence sur Traduction de texte v3.0