Traducción de un único documento

Traduzca un único documento y reciba la salida traducida en la respuesta HTTP. Esta operación no requiere Azure Blob Storage, lo que hace que sea adecuado para la traducción interactiva, las integraciones ligeras y las pruebas. La solicitud usa datos de varias partes o formularios para pasar el documento y devuelve el archivo traducido como datos binarios en el cuerpo de la respuesta.

Método HTTP: VERSIÓN de LA API POST : 2026-03-01

Solicitud

POST {endpoint}/translator/document:translate?targetLanguage={targetLanguage}&api-version=2026-03-01

Cabeceras de solicitud

Cabecera Obligatorio Descripción
Ocp-Apim-Subscription-Key Sí La clave de recurso de Translator desde el portal de Azure.
Ocp-Apim-Subscription-Region Condicional Obligatorio si usa un recurso regional.
Content-Type Sí multipart/form-data

Parámetros de consulta

Parámetro Obligatorio Descripción
targetLanguage Sí Código de idioma de destino (por ejemplo, fr, de, ja).
sourceLanguage No Código de idioma fuente. Si se omite, el servicio detecta automáticamente el idioma de origen.
category No Identificador de categoría de Traductor personalizado.
allowFallback No booleano. Establézcalo en true para permitir la reversión a la traducción general si un sistema personalizado no está disponible. Valor predeterminado: true.
api-version Sí Versión de la API. Valor actual: 2026-03-01.

Cuerpo de la solicitud

La solicitud usa multipart/form-data. Incluya las siguientes partes:

Parte Obligatorio Descripción
document Sí Archivo que se va a traducir. Especifique el contenido del archivo y el tipo MIME.
glossary No Un archivo de glosario para aplicar terminología personalizada. Especifique el contenido del archivo y el tipo MIME.

Solicitudes de ejemplo

Traducción basada en NMT

curl -X POST "{endpoint}/translator/document:translate?targetLanguage=fr&api-version=2026-03-01" \
  -H "Ocp-Apim-Subscription-Key: {key}" \
  -F "document=@{path/to/document.docx};type=application/vnd.openxmlformats-officedocument.wordprocessingml.document" \
  -o translated.docx

Traducción con glosario

curl -X POST "{endpoint}/translator/document:translate?targetLanguage=es&api-version=2026-03-01" \
  -H "Ocp-Apim-Subscription-Key: {key}" \
  -F "document=@{path/to/document.docx};type=application/vnd.openxmlformats-officedocument.wordprocessingml.document" \
  -F "glossary=@{path/to/glossary.tsv};type=text/tab-separated-values" \
  -o translated.docx

Respuesta

Códigos de estado de respuesta

Código de estado Descripción
200 De acuerdo. Devuelve el documento traducido como datos binarios.
400 Solicitud incorrecta. Compruebe los parámetros de consulta y los datos del formulario.
401 Error de autenticación. Compruebe la clave de suscripción.
415 Tipo de medio no admitido. Compruebe el tipo MIME del documento.
429 Demasiadas solicitudes. Reduzca la frecuencia de solicitud.
500 Error interno del servidor.

El cuerpo de 200 la respuesta es el archivo de documento traducido. Guárdelo con la -o marca en curl o el equivalente en el cliente HTTP.

Contenido relacionado

  • Last updated on