SDK de traducción de documentos

La traducción de documentos es una característica basada en la nube de Azure Translator en Foundry Tools. Admite la traducción por lotes asincrónica y la traducción sincrónica de documentos únicos en los idiomas y formatos de archivo admitidos. Los kits de desarrollo de software (SDK) de traducción de documentos le ayudan a integrar estas funcionalidades de API REST en sus aplicaciones.

Prerequisites

Para usar un SDK de traducción de documentos, necesita:

Idiomas compatibles

El SDK de traducción de documentos admite los siguientes lenguajes de programación:

Idioma y versión del SDK Paquete Biblioteca de cliente Versión predeterminada de la API
.NET/C# 3.0.0 NuGet SDK de Azure para .NET 2026-03-01
Python 2.0.0 PyPI SDK de Azure para Python 2026-03-01
JavaScript/TypeScript 1.0.0 npm SDK de Azure para JavaScript 2026-03-01
Java 2.0.0 Maven Central SDK de Azure para Java 2026-03-01

Registro de cambios e historial de versiones

En esta sección se proporciona una descripción por versiones de la función de traducción de documentos y de los lanzamientos de capacidades, cambios, actualizaciones y mejoras.

Uso del SDK de traducción de documentos en las aplicaciones

El SDK de traducción de documentos permite el uso y la administración del servicio de traducción en la aplicación. El SDK se basa en las API REST de traducción de documentos subyacentes para su uso en el paradigma del lenguaje de programación. Elija el lenguaje de programación que prefiera:

1. Instale la biblioteca cliente de SDK

dotnet add package Azure.AI.Translation.Document --version 3.0.0
Install-Package Azure.AI.Translation.Document -Version 3.0.0

2. Importe la biblioteca cliente del SDK en la aplicación

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

3. Autenticar el cliente

Cree una instancia del DocumentTranslationClient objeto para interactuar con el SDK de traducción de documentos y, a continuación, llame a métodos en ese objeto cliente para interactuar con el servicio. DocumentTranslationClient es la interfaz principal para usar la biblioteca cliente de traducción de documentos. Proporciona métodos tanto sincrónicos como asincrónicos para realizar las operaciones.

Traducción por lotes asincrónica

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));

Traducción de documentos únicos asincrónica

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. Compilación de la aplicación

Traducción por lotes asincrónica

Las interfaces por lotes de traducción de documentos requieren la entrada siguiente:

  1. Cargue los archivos en un contenedor de origen de Azure Blob Storage (sourceUri).
  2. Proporcione un contenedor de destino donde se puedan escribir los documentos traducidos (targetUri).
  3. Incluya el código de idioma de destino (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);

Traducción de documentos únicos asincrónica

Traducción de documentos únicos

Opciones de ayuda

Los Microsoft Q&A foros de y Stack Overflow están disponibles para que la comunidad de desarrolladores pregunte y responda preguntas sobre la traducción de texto de Azure y otros servicios. Microsoft supervisa los foros y responde a preguntas que la comunidad aún no ha respondido.

Sugerencia

Para asegurarse de que veamos su pregunta de Microsoft Q&A, etiquétela con microsoft-translator. Para asegurarse de que veamos su pregunta de Stack Overflow, etiquétela con Azure Translator.

Pasos siguientes