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

2025-06-06

La traduction de texte Azure est une fonctionnalité d’API REST basée sur le cloud du service Azure AI Translator. L’API Traduction de texte permet des traductions de texte rapides et précises en temps réel. Le Kit de développement logiciel de traduction de texte (SDK) 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 SDK de 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 de client	Version de l’API prise en charge
.NET/C# → 1.0.0	NuGet	Kit de développement logiciel (SDK) Azure pour .NET	Translator v3.0
Java✱ → 1.0.0	Référentiel Maven	Kit de développement logiciel (SDK) Azure pour Java	Translator v3.0
JavaScript → 1.0.0	npm	Kit de développement logiciel (SDK) pour JavaScript	Translator v3.0
Python → 1.0.1	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 sur 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

Cette section fournit une description basée sur la version des fonctionnalités de traduction de texte, des changements, des mises à jour et des améliorations.

Version de mai 2024 (GA) du Kit de développement logiciel (SDK) Translator Text

Cette version inclut les mises à jour suivantes :

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) de traduction de texte dans vos applications

Le Kit de développement logiciel (SDK) de traduction de texte permet l’utilisation et la gestion du service de traduction de texte dans votre application. Le Kit de développement logiciel (SDK) repose sur l’API REST de traduction de texte sous-jacente qui vous permet d’utiliser facilement ces API dans votre paradigme de langage de programmation. Voici comment utiliser le Kit de développement logiciel (SDK) de traduction de texte pour 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 AzureKeyCredential
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 de traduction de texte se trouve dans le portail Azure :

Capture d’écran de l’emplacement des clés et des points de terminaison sur le portail Azure.

À 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) de traduction de texte, puis appelez 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’exemples de traduction de texte pour .NET/C#.

Options d’aide

Les forums Microsoft Q &A et Stack Overflow sont disponibles pour la communauté des développeurs afin de poser et de répondre à des questions sur la traduction de texte Azure et d’autres services. 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 la traduction de texte

Guide de référence de traduction de texte v3.0