Guía de la API REST de traducción de documentos (2026-03-01)

La API REST de traducción de documentos (versión 2026-03-01) admite dos modelos de traducción y un conjunto de operaciones de detección. La traducción sincrónica procesa un solo documento sin Blob Storage y devuelve el archivo traducido directamente. La traducción por lotes asincrónica procesa uno o varios documentos almacenados en Azure Blob Storage y permite sondear el estado. Ambos modelos usan la traducción automática neuronal (NMT) de forma predeterminada.

Todas las solicitudes requieren un punto de conexión de dominio personalizado. El formato es https://{your-resource-name}.cognitiveservices.azure.com/.

Note

Para las aplicaciones existentes que usan api anteriores, consulte la guía heredada de la API rest de traducción de documentos.

Operaciones sincrónicas

Operación Método Description Reference
Traducción de un documento POST Traduzca un único documento y reciba la salida traducida en la respuesta. No se requiere Blob Storage. Traducción sincrónica de documentos

Operaciones por lotes asincrónicas

Operación Método Description Reference
Iniciar traducción por lotes POST Envíe uno o varios documentos para la traducción asincrónica. Los documentos deben estar en Azure Blob Storage. Devuelve un identificador de trabajo. Iniciar traducción por lotes
Obtención del estado de la traducción GET Recupere el estado general y el resumen del documento de un trabajo por lotes específico. Sondee hasta que el trabajo alcance un estado terminal. Obtención del estado de traducción
Obtener el estado de todas las traducciones GET Enumere todos los trabajos de traducción por lotes enviados al recurso. Admite el filtrado y la paginación. Obtener el estado de todos los trabajos de traducción
Obtener el estado de todos los documentos GET Recupere el estado por documento de todos los documentos de un trabajo específico. Obtener el estado de todos los documentos
Obtener el estado de un documento específico GET Recupere los detalles de estado y salida de un único documento dentro de un trabajo. Obtener el estado de un documento específico
Cancelación de la traducción DELETE Cancele un trabajo en cola o en curso. Cancelación de la traducción

Operaciones de detección

Operación Método Description Reference
Obtención de formatos de documento admitidos GET Recupere una lista de formatos de documento admitidos y sus tipos MIME. Obtención de formatos de documento admitidos
Obtención de formatos de glosario admitidos GET Recupere una lista de formatos de glosario admitidos y sus tipos MIME. Obtención de formatos de glosario admitidos