Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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:
- Una suscripción a Azure activa.
- Un recurso de Azure Translator de servicio único.
- Punto de conexión y clave personalizados para el recurso de Translator.
- Para la traducción por lotes asincrónica, una cuenta de Azure Blob Storage con contenedores de origen y destino. Para ver las opciones de autorización, consulte Autorización de contenedor de almacenamiento.
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.
Versión 3.0.0
Registro de cambios/Historial de versiones
LÉAME
Ejemplos
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:
- Cargue los archivos en un contenedor de origen de Azure Blob Storage (sourceUri).
- Proporcione un contenedor de destino donde se puedan escribir los documentos traducidos (targetUri).
- 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
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.