Condividi tramite

SDK per la traduzione di documenti

  • Articolo

Traduzione documenti è una funzionalità API REST basata sul cloud del servizio Traduttore per Azure AI. L'API Traduzione documenti consente traduzioni rapide e accurate di documenti interi di origine, in modo asincrono, nelle lingue supportate e nei vari formati di file. L'SDK (Software Development Kit) Traduzione di documenti è un set di librerie e strumenti che consentono di integrare facilmente le funzionalità dell'API REST Traduzione di documenti nelle applicazioni.

Lingue supportate

L'SDK Traduzione di documenti supporta i linguaggi di programmazione seguenti:

Lingua → Versione SDK Pacchetto Libreria client Versione dell'API supportata
🆕 .NET/C# → 2.0.0-beta.1 NuGet Azure SDK per .NET Traduzione di documenti api-version=2024-05-01
🆕 Python → 1.1.0b1 PyPi Azure SDK per Python Traduzione di documenti api-version=2024-05-01

Log delle modifiche e cronologia delle versioni

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

Usare l'SDK Traduzione di documenti nelle applicazioni

L'SDK Traduzione di documenti consente l'uso e la gestione del servizio di traduzione nell'applicazione. L'SDK si basa sulle API REST Traduzione di documenti sottostanti per l'uso all'interno del paradigma del linguaggio di programmazione. Scegliere il linguaggio di programmazione preferito:

1. Installare la libreria client SDK

dotnet add package Azure.AI.Translation.Document --version 2.0.0-beta.1

Install-Package Azure.AI.Translation.Document -Version 2.0.0-beta.1

2. Importare la libreria client SDK nell'applicazione

using System;
using Azure.Core;
using Azure.AI.Translation.Document;

3. Autenticare il client

Creare un'istanza dell'oggetto DocumentTranslationClient per interagire con l'SDK Traduzione di documenti e quindi chiamare i metodi su tale oggetto client per interagire con il servizio. DocumentTranslationClient è l'interfaccia principale per l'uso della libreria client di Traduzione di documenti. Fornisce sia metodi sincroni che asincroni per eseguire operazioni.

Traduzione batch asincrona

private static readonly string endpoint = "<your-custom-endpoint>";
private static readonly string key = "<your-key>";

DocumentTranslationClient client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(key));

Traduzione sincrona di singoli documenti

private static readonly string endpoint = "<your-custom-endpoint>";
private static readonly string key = "<your-key>";

SingleDocumentTranslationClient client = new SingleDocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));

4. Compilare l'applicazione

Traduzione batch asincrona

Le interfacce batch di Traduzione di documenti richiedono l'input seguente:

  1. Caricare i file in un contenitore di origine di Archiviazione BLOB di Azure (sourceUri).
  2. Specificare un contenitore di destinazione in cui è possibile scrivere i documenti tradotti (targetUri).
  3. Includere il codice lingua che identifica la lingua di destinazione (targetLanguage).

Uri sourceUri = new Uri("<your-source container-url");
Uri targetUri = new Uri("<your-target-container-url>");
string targetLanguage = "<target-language-code>";

DocumentTranslationInput input = new DocumentTranslationInput(sourceUri, targetUri, targetLanguage)

Traduzione sincrona di singoli documenti

Traduzione di singoli documenti

Opzioni di assistenza

I forum Microsoft Q&A e Stack Overflow sono a disposizione della community di sviluppatori per porre e rispondere a domande su Traduzione testuale di Azure e altri servizi. Microsoft monitora i forum e risponde alle domande a cui la community deve ancora rispondere.

Suggerimento

Per assicurarsi che la domanda venga visualizzata, contrassegnarla con microsoft-translator. Per assicurarsi che la domanda Stack Overflow venga visualizzata, contrassegnarla con Azure AI Translator.

Passaggi successivi

Guida introduttiva agli SDK Traduzione di documentiRiferimento all'API REST Traduzione di documenti v1.1