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.
Azure Translator Text API 2026-06-06 es la versión más reciente disponible con carácter general (GA), disponible a través de Microsoft Foundry. Si actualmente usa Translator Text API v3.0, esta guía le guiará por lo que ha cambiado y cómo actualizar la integración.
La nueva versión presenta opciones de modelo expandidas, nuevos controles de traducción y un esquema de solicitud y respuesta revisados. No es retrocompatible con la versión 3.0: debe actualizar la versión de la API, la estructura de la carga útil y cualquier código que dependa de métodos específicos de la versión 3.0.
Importante
- La versión
2026-06-06de la API no sustituye directamente a la v3.0. Se requieren cambios en la estructura de solicitudes, el esquema de respuesta y los métodos admitidos. - Pruebe la aplicación exhaustivamente en un entorno que no sea de producción antes de migrar las cargas de trabajo de producción.
- Valide el código y los flujos de trabajo internos y restrinja las implementaciones de producción a las versiones de API que pruebe por completo.
Novedades de la API versión 2026-06-06
Hay funcionalidades clave agregadas en la 2026-06-06 API. Revise cada uno para comprender si se aplica a la integración y si requiere cambios de código o abre nuevos escenarios para la aplicación.
Selección del modelo de lenguaje grande (LLM). Ahora puede elegir entre traducción automática neuronal estándar (NMT) y un modelo de lenguaje grande compatible (LLM), como GPT-5.1, para cada solicitud de traducción. Esta concesión permite equilibrar calidad, coste y rendimiento sin administrar canalizaciones de ingeniería de solicitudes o de calidad manual. La traducción basada en LLM requiere un recurso Microsoft Foundry.
Traducción personalizada adaptable. Puede proporcionar hasta cinco pares de traducciones de referencia o un identificador de índice de un conjunto de datos adaptativo para guiar el resultado del LLM hacia el estilo y la terminología que prefiera. Este margen es útil para contenido específico de un dominio o aplicaciones con glosarios establecidos.
Controles de tono y género. Las solicitudes de traducción ahora aceptan parámetros de tono (formal, informal, neutro) y género (masculino, femenino, neutro) al usar la traducción basada en LLM. Estos parámetros son opcionales, pero permiten generar una salida más dirigida para escenarios específicos de la audiencia.
Cambios en el método
La 2026-06-06 API cambia varios parámetros necesarios y quita los métodos compatibles con v3.0. Revise las tablas siguientes para identificar lo que necesita actualizar en el código.
Advertencia
- La versión
2025-10-01-previewde la API está en desuso 90 días después de la disponibilidad general. - Para migrar de
2025-10-01-previewa GA, establezcaapi-version=2026-06-06.
Parámetros necesarios
El cambio estructural más importante es el reemplazo del parámetro v3.0 to con una targets matriz. Actualice todas las solicitudes de traducción para usar el nuevo esquema.
| Versión de API: 2026-06-06 | Versión de API: v3.0 |
|---|---|
|
api-version • El valor debe ser 2026-06-06 |
api-version • El valor debe ser 3.0 |
|
text • Especifica el texto de origen que se va a traducir. |
text • Especifica el texto de origen que se va a traducir. |
|
Objetivos • Matriz que define uno o varios destinos de traducción. |
• La targets matriz no se usa en el esquema v3.0. |
|
en • Código de idioma de destino especificado dentro de la targets matriz.• Los valores deben ser de los idiomas admitidos. |
to • Especifica el idioma de destino para la traducción. • Los valores deben ser de los idiomas admitidos. |
Para obtener más información sobre los valores de matriz admitidostargets, consulte Traducción de texto.
Compatibilidad de API
Varios métodos v3.0 ya no están disponibles en 2026-06-06. Si la aplicación usa cualquiera de los métodos eliminados, planee un reemplazo antes de migrar.
| Azure Translator v3.0 | Azure Translator 2026-06-06 |
|---|---|
| Traducir texto | Traducir texto |
| Transliterar | Transliterar |
| Idiomas | Idiomas |
| BreakSentence | Ya no se admite. Reemplace por una función delimitador de oraciones o una biblioteca de procesamiento de lenguaje natural (NLP) compatible con el lenguaje de programación. |
| Detectar | Ya no se admite. Sustituya por la API de detección de Lenguaje de Azure AI. |
| Búsqueda de diccionarios | Ya no se admite. Considere la posibilidad de usar la traducción personalizada adaptable para el control de términos específicos del dominio. |
| Ejemplos de diccionario | Ya no se admite. |