SDK di Traduzione testo di Azure

Articolo
09/30/2024

Traduzione testuale di Azure è una funzionalità API REST basata sul cloud del servizio Traduttore per Azure AI. L'API Traduzione testuale consente traduzioni di testo rapide e accurate in tempo reale. Il Software Development Kit (SDK) per la traduzione testuale è un set di librerie e strumenti che consentono di integrare facilmente le funzionalità dell'API REST di Traduzione testuale nelle applicazioni. L'SDK di Traduzione testuale è disponibile per varie piattaforme di programmazione in C#/.NET, Java, JavaScript e Python.

Lingue supportate

L'SDK per la traduzione testuale supporta i linguaggi di programmazione e le piattaforme:

Lingua → Versione SDK	Pacchetto	Libreria client	Versione dell'API supportata
.NET/C# → 1.0.0	NuGet	Azure SDK per .NET	Translator v3.0
Java✱ → 1.0.0	Repository Maveny	Azure SDK per Java	Translator v3.0
JavaScript → 1.0.0	npm	Azure SDK per JavaScript	Translator v3.0
Python → 1.0.1	PyPi	Azure SDK per Python	Translator v3.0

✱ L'SDK di Traduzione testuale di Azure per Java è testato e supportato nelle piattaforme Windows, Linux e macOS. Non viene testato su altre piattaforme e non supporta le distribuzioni Android.

Log delle modifiche e cronologia delle versioni

In questa sezione viene fornita una descrizione basata sulla versione delle versioni delle funzionalità, delle modifiche, degli aggiornamenti e dei miglioramenti di Traduzione testuale.

Versione di maggio 2024 dell'SDK di Traduzione testuale

Questa versione include gli aggiornamenti seguenti:

Versione 1.0.0 (21-05-2024)
Destinata a Traduzione testuale v3.0
Versione release in disponibilità generale

Pacchetto (NuGet)

Log delle modifiche/Cronologia delle versioni

README

Esempi

Versione di anteprima di aprile 2023 dell'SDK di Traduttore testuale

Questa versione include gli aggiornamenti seguenti:

Usare l'SDK di Traduzione testuale nelle applicazioni

L'SDK di Traduzione testuale consente l'uso e la gestione del servizio Traduzione testuale nell'applicazione. L'SDK si basa sull'API REST di Traduzione testuale sottostante che consente di usare facilmente tali API all'interno del paradigma del linguaggio di programmazione. Ecco come usare l'SDK di Traduzione testuale per il linguaggio di programmazione preferito:

1. Installare la libreria client 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. Importare la libreria client SDK nell'applicazione

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. Autenticare il client

Per interagire con il servizio Traduttore usando la libreria client, è necessario creare un'istanza della classe TextTranslationClient. È necessaria la chiave API e l'area per creare un'istanza di un oggetto client. La chiave dell'API Traduzione testuale è disponibile nel portale di Azure:

Screenshot della posizione di chiavi ed endpoint nel portale di Azure.

Uso dell'endpoint globale (impostazione predefinita)

string key = "<your-key>";

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

Uso di un endpoint a livello di area


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

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

Uso dell'endpoint globale (impostazione predefinita)


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

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

Uso di un endpoint a livello di area

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. Compilare l'applicazione

Creare un oggetto client per interagire con l'SDK di Traduzione testuale e quindi chiamare i metodi su tale oggetto client per interagire con il servizio. Gli SDK forniscono metodi sincroni e asincroni. Per altre informazioni dettagliate, vedere il repository di esempi di Traduzione testuale per .NET/C#.

Opzioni di assistenza

I forum Microsoft Q&A eStack Overflow sono a disposizione della community di sviluppatori per porre e rispondere a domande su Traduzione testo di Azure e altri servizi. Microsoft monitora i forum e risponde alle domande a cui la community deve ancora rispondere. Per assicurarsi che venga visualizzata la domanda, contrassegnarla con azure-text-translation.

Passaggi successivi

Avvio rapido per Traduzione testuale

Guida di riferimento per Traduzione testuale v3.0

Condividi tramite