SDK per la traduzione di documenti

La traduzione dei documenti è una funzionalità basata sul cloud di Traduttore di Azure in Strumenti foundry. Supporta la traduzione batch asincrona e la traduzione sincrona a documento singolo tra lingue e formati di file supportati. Gli SDK (Document Translation Software Development Kit) consentono di integrare queste funzionalità dell'API REST nelle applicazioni.

Prerequisiti

Per usare document translation SDK, è necessario:

Lingue supportate

Document Translation SDK supporta i linguaggi di programmazione seguenti:

Versione del linguaggio e dell'SDK Pacchetto Libreria client Versione DELL'API predefinita
.NET/C# 3.0.0 NuGet Azure SDK per .NET 2026-03-01
Python 2.0.0 PyPI Azure SDK per Python 2026-03-01
JavaScript/TypeScript 1.0.0 npm Azure SDK per JavaScript 2026-03-01
Java 2.0.0 Maven Central Azure SDK per Java 2026-03-01

Log delle modifiche e cronologia delle versioni

In questa sezione viene fornita una descrizione basata sulle versioni della funzionalità di traduzione dei documenti e delle sue capacità, compresi i rilasci, le modifiche, gli aggiornamenti e i miglioramenti.

Usare Document Translation SDK nelle applicazioni

Document Translation SDK consente l'uso e la gestione del servizio di traduzione nell'applicazione. L'SDK si basa sulle API REST di traduzione dei 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 3.0.0
Install-Package Azure.AI.Translation.Document -Version 3.0.0

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 Document Translation SDK 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 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(key));

4. Compilare l'applicazione

Traduzione batch asincrona

Le interfacce batch di traduzione dei 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 Microsoft Q&A forum e Stack Overflow sono disponibili per la community di sviluppatori per porre e rispondere a domande sulla traduzione testuale di Azure e su altri servizi. Microsoft monitora i forum e risponde alle domande a cui la community deve ancora rispondere.

Suggerimento

Per assicurarsi che la domanda di Microsoft Q&A venga visualizzata, contrassegnarla con microsoft-translator. Per assicurarsi che la domanda Stack Overflow venga visualizzata, contrassegnarla con Traduttore di Azure.

Passaggi successivi