¿Qué es la traducción de texto de Azure en Microsoft Foundry?

Azure traducción de texto es una API REST basada en la nube para la traducción multilingüe en más de 100 idiomas y dialectos admitidos. Puede integrarlo en aplicaciones, servicios y flujos de trabajo de automatización para traducir texto en tiempo real a escala de producción mediante API REST o SDK.

La versión más reciente disponible con carácter general es 2026-06-06. Esta versión presenta un esquema de solicitud y respuesta revisado, agrega compatibilidad con la selección de modelos entre traducción automática neuronal estándar (NMT) y modelos de lenguaje grandes (LLM) compatibles y expande controles de traducción para escenarios que requieren variaciones adaptables de salida, tono y género.

Translator está diseñado para cargas de trabajo multilingües de gran volumen en las que la coherencia, la escalabilidad y el control operativo son importantes. Si actualmente está en la versión 3.0, planifique la migración y la validación antes de la implementación, porque 2026-06-06 incluye cambios importantes.

Novedades de 2026-06-06 (GA)

La versión 2026-06-06 de la API está disponible con carácter general e incluye cambios importantes en comparación con la versión 3.0.

Esta versión agrega nuevos controles de traducción y opciones de modelo al actualizar los contratos de solicitud y respuesta. Si va a migrar desde la versión 3.0, planee un pase de validación completo para la forma de carga, el análisis de respuestas y las comprobaciones de calidad de producción antes del lanzamiento.

Importante

  • Azure Translator API REST 2026-06-06 introduce cambios importantes.
  • Pruebe exhaustivamente las aplicaciones antes de migrar cargas de trabajo de producción desde la versión 3.0.
  • Valide las rutas de acceso de código y los flujos de trabajo internos y restrinja el uso de producción a las versiones que ha probado por completo.

Las actualizaciones clave de 2026-06-06 incluyen:

  • Esquema JSON de solicitud y respuesta revisados. La matriz de solicitudes usa inputsy la matriz de respuesta usa value. Para ver un ejemplo completo, consulte la guía de la API REST.
  • Elección del modelo (NMT o LLM). Puede seleccionar NMT estándar o una implementación de LLM (por ejemplo, GPT-5.1) en función de los requisitos de calidad, costo y escenario. El uso de la traducción basada en LLM requiere un recurso Microsoft Foundry. Para obtener instrucciones de configuración, consulte Creación de recursos de Translator.
  • Traducción personalizada adaptable. Puede proporcionar hasta cinco traducciones de referencia o un identificador de índice de conjunto de datos adaptable para influir en el estilo de salida y la terminología del LLM. Para obtener más información, consulte Traducción personalizada adaptable.
  • Controles de tono y género. La traducción basada en LLM admite variantes de tono (formales, informales, neutros) y controles de salida específicos del género.

Operaciones principales

La 2026-06-06 API incluye las siguientes operaciones principales:

Estas operaciones cubren las necesidades operativas en tiempo de ejecución más comunes de las canalizaciones de localización de texto: identificación de los idiomas admitidos, traducción de texto a gran escala y transliteración de sistemas de escritura para pares de idiomas que requieren conversión entre sistemas de escritura.

  • Idiomas: devuelve los idiomas admitidos para las operaciones de traducción. Esta solicitud no requiere autenticación.

    https://api.cognitive.microsofttranslator.com/languages?api-version=2026-06-06

  • Traducir: traduce el texto de origen a uno o varios idiomas de destino en una sola POST solicitud.

  • Transliterar: convierte sistemas de escritura o conjuntos de caracteres de un sistema de escritura a otro.

Para ver un tutorial de solicitud completo, consulte la guía de api rest.

Opciones de desarrollo

Use las siguientes opciones para compilar e implementar soluciones de traducción de texto multilingües en sus aplicaciones y flujos de trabajo:

Elija la ruta de acceso de integración en función de la cantidad de control y automatización que necesite. La mayoría de los sistemas de producción usan la integración directa de la API REST o el SDK, mientras que los flujos de trabajo del portal pueden ser útiles para la configuración, las pruebas y la solución de problemas operativos.

Opción desarrollo Descripción
Portal de Microsoft Foundry Use Microsoft Foundry para administrar proyectos, modelos y recursos de inteligencia artificial relacionados.
REST API Integre directamente con las API REST de traducción de texto.
Bibliotecas cliente (SDK) Desarrolla con SDK compatibles mediante guías de inicio rápido de la biblioteca cliente.
Contenedor de Docker Use el contenedor de Translator para escenarios desconectados o controlados compatibles. Comience con Contenedor: traducir texto.

Autenticación

Todas las solicitudes de traducción de texto requieren encabezados de autenticación. Para las implementaciones de producción, elija un enfoque que coincida con el modelo de seguridad y operaciones. Las claves de recurso son una opción sencilla para empezar, mientras que Microsoft Entra ID suele ser la opción preferida para entornos empresariales que requieren identidad centralizada y acceso sin claves.

Método Descripción
Clave de recurso Pase Ocp-Apim-Subscription-Key desde su recurso de Translator.
Token de portador Obtenga un token temporal y envíelo en el encabezado Authorization.
Microsoft Entra ID Use identidades administradas o entidades de servicio para la autenticación sin claves.

Para ver los encabezados necesarios y ejemplos específicos del punto de conexión, consulte Autenticación y autorización.

Puntos de conexión y residencia de datos

La traducción de texto admite puntos de conexión globales, geográficos y específicos de recursos. La selección del punto de conexión determina dónde procesa Translator las solicitudes de NMT. Para ver las direcciones URL del punto de conexión, las ubicaciones de procesamiento y las diferencias de implementación de Foundry LLM, consulte Compatibilidad con regiones para Azure Translator.

Procesamiento, límites y precios de LLM

Para las implementaciones mixtas de NMT y LLM, trate el enrutamiento del modelo, los límites y el costo como parte del diseño en tiempo de ejecución. El rendimiento y el dimensionamiento de la carga difieren entre las rutas de NMT y LLM, por tanto, aplique una línea de base tanto a la latencia como al coste antes de escalar el tráfico.

Límites de servicio

Operación Número máximo de elementos de matriz Tamaño máximo del elemento de matriz Número máximo de elementos de matriz de LLM Tamaño máximo de LLM del elemento de matriz
Traducir 1,000 50,000 50 5.000

Para obtener cuotas y límites más amplios, consulte Límites de servicio: Translator.

Pricing

Si admite varios niveles de tráfico, defina reglas de enrutamiento que reserven el uso de LLM para escenarios que requieren un comportamiento adaptable, un control de tono o un control contextual más enriquecido, y mantenga el tráfico de línea base de alto volumen en NMT cuando corresponda.

Solución de problemas

Si se produce un error en una solicitud, comience con el estado HTTP y el código de error del servicio.

En los sistemas de producción, la manera más rápida de aislar problemas es registrar identificadores de solicitud, punto de conexión, región, versión de API y encabezados de clave con cada llamada con error. Este contexto ayuda a distinguir errores de autenticación, cuota, carga y disponibilidad de características.

Síntoma Causa probable Resolución
401 Unauthorized Falta la clave de suscripción o no es válida. Compruebe Ocp-Apim-Subscription-Key y la asociación de recursos.
403 Forbidden Credenciales válidas, pero operación o configuración no admitidas. Confirme la región, el tipo de recurso y la disponibilidad de características.
429 Too Many Requests Tasa o cuota superada. Reduzca la tasa de solicitudes y revise los límites del servicio.
400 Bad Request Carga no válida o valor de idioma no admitido. Valide la solicitud JSON y los lenguajes admitidos.

Para obtener códigos detallados, consulte Códigos de respuesta y mensajes.

Primeros pasos

Use esta secuencia para pasar del aprovisionamiento al primer flujo de trabajo de traducción validado. Mantenga las cargas de prueba pequeñas al principio y, a continuación, escale el tamaño y la simultaneidad de las solicitudes después de validar la autenticación, el enrutamiento de puntos de conexión y el control de respuestas.

  1. Cree un recurso de Translator.
  2. Obtenga las claves de acceso y la dirección URL del punto de conexión.
  3. Ejecute el inicio rápido de traducción de texto en su idioma preferido:

Contenido relacionado

  • Last updated on