Guía de la API rest de traducción de documentos (2024-05-01)

La API REST de traducción de documentos (versión 2024-05-01) heredada admite la traducción sincrónica de documentos únicos, la traducción por lotes asincrónica y las 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.

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

Nota:

Para las nuevas aplicaciones, use la API REST de traducción de documentos versión 2026-03-01.

Operaciones sincrónicas

Funcionamiento Método Descripción Referencia
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

Funcionamiento Método Descripción Referencia
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 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

Funcionamiento Método Descripción Referencia
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

API por lotes v1.1 anterior

La API v1.1 anterior admite operaciones de detección y lotes asincrónicas en la /translator/text/batch/v1.1 ruta de acceso. La Get supported storage sources operación solo está disponible en v1.1. Translator admite Azure Blob Storage como origen de almacenamiento.

Se recomienda migrar las aplicaciones existentes a la versión más reciente de la API para usar las funcionalidades actuales.

Funcionamiento Método Ruta de acceso de API
Iniciar traducción por lotes POST /translator/text/batch/v1.1/batches
Obtener el estado de todos los trabajos de traducción GET /translator/text/batch/v1.1/batches
Obtención del estado de un trabajo de traducción específico GET /translator/text/batch/v1.1/batches/{id}
Obtener el estado de todos los documentos GET /translator/text/batch/v1.1/batches/{id}/documents
Obtener el estado de un documento específico GET /translator/text/batch/v1.1/batches/{id}/documents/{documentId}
Cancelación de la traducción DELETE /translator/text/batch/v1.1/batches/{id}
Obtención de formatos de documento admitidos GET /translator/text/batch/v1.1/documents/formats
Obtención de formatos de glosario admitidos GET /translator/text/batch/v1.1/glossaries/formats
Obtención de orígenes de almacenamiento admitidos GET /translator/text/batch/v1.1/storagesources

Contenido relacionado

  • Last updated on