Migración de Translator V2 a V3
Nota
V2 quedó en desuso el 30 de abril de 2018. Migre sus aplicaciones a V3 para aprovechar la nueva funcionalidad disponible exclusivamente en V3. V2 se retiró el 24 de mayo de 2021.
El equipo de Microsoft Translator ha lanzado la versión 3 (V3) de Translator. En esta versión se incluyen nuevas características, métodos en desuso y un nuevo formato para enviar y recibir datos del servicio Microsoft Translator. Este documento proporciona información para cambiar las aplicaciones para que usen V3.
El final de este documento contiene vínculos útiles para que pueda obtener más información.
Resumen de características
- Sin seguimiento: en V3 se aplica la función Sin seguimiento a todos los niveles de precios en Azure Portal. Esta característica significa que Microsoft no guardará ningún texto enviado a la API V3.
- JSON: XML se reemplaza con JSON. Todos los datos enviados al servicio y recibidos desde el mismo están en formato JSON.
- Varios idiomas de destino en una única solicitud: el método de traducción acepta varios idiomas de destino para la traducción en una única solicitud. Por ejemplo, una sola solicitud puede traducirse desde el inglés al alemán, español y japonés, o a cualquier otro grupo de idiomas.
- Diccionario bilingüe: se ha agregado un método de diccionario bilingüe a la API. Este método incluye las opciones "búsquedas" y "ejemplos".
- Transliterar: se ha agregado un método de transliteración a la API. Este método convertirá las palabras y oraciones de un script en otro script. Por ejemplo, árabe a latino.
- Idiomas: un nuevo método denominado "idiomas" ofrece información sobre el idioma en formato JSON, y se puede usar con los métodos "traducir", "diccionario" y "transliterar".
- Novedades en Traducir: se han agregado nuevas capacidades al método "traducir" para admitir algunas de las características que se encontraban en la API V2 como métodos separados. Un ejemplo es TranslateArray.
- Método Leer: la funcionalidad de conversión de texto a voz ya no se admite en Microsoft Translator. La funcionalidad de texto a voz está disponible en el servicio Voz de Microsoft.
La siguiente lista de métodos V2 y V3 identifica los métodos V3 y las API que proporcionarán la funcionalidad de V2.
| Método de API V2 | Compatibilidad de API V3 |
|---|---|
Translate |
Traducir |
TranslateArray |
Traducir |
GetLanguageNames |
Idiomas |
GetLanguagesForTranslate |
Idiomas |
GetLanguagesForSpeak |
Servicio Voz de Microsoft |
Speak |
Servicio Voz de Microsoft |
Detect |
Detectar |
DetectArray |
Detectar |
AddTranslation |
Esta característica ya no se admite. |
AddTranslationArray |
Esta característica ya no se admite. |
BreakSentences |
BreakSentence |
GetTranslations |
Esta característica ya no se admite. |
GetTranslationsArray |
Esta característica ya no se admite. |
Cambiar al formato JSON
Microsoft Translator Translation V2 aceptaba y devolvía datos en formato XML. En V3, todos los datos que se envían y se reciben mediante la API están en formato JSON. XML ya no se aceptará ni devolverá datos en V3.
Este cambio afectará a varios aspectos de una aplicación escrita para la versión V2 de Text Translation API. Por ejemplo: la API de idiomas devuelve información sobre el idioma que se usará en la traducción de texto, la transliteración y los dos métodos de diccionario. Puede solicitar toda la información del idioma para todos los métodos en una sola llamada o solicitarlos individualmente.
El método de idiomas no requiere autenticación; si selecciona el siguiente vínculo podrá ver toda la información de idioma para V3 en JSON:
Clave de autenticación
La clave de autenticación que está utilizando para V2 se aceptará en V3. No necesita obtener una nueva suscripción. Podrá mezclar V2 y V3 en sus aplicaciones durante el período de migración de un año; así será más fácil lanzar de nuevas versiones mientras todavía está migrando de V2-XML a V3-JSON.
Modelo de precios
Microsoft Translator V3 tiene el mismo precio que V2; esto es, por carácter e incluyendo los espacios. Las nuevas características de V3 realizan algunos cambios en los caracteres que se cuentan para la facturación.
| Método V3 | Caracteres que se cuentan para la facturación |
|---|---|
Languages |
Si no se envían caracteres, no se cuenta ninguno y no hay cargo. |
Translate |
El recuento se basa en la cantidad de caracteres que se envían para la traducción, y en el número de idiomas a los que se traducen los caracteres. 50 caracteres enviados más 5 idiomas solicitados, serán 50x5. |
Transliterate |
Se cuenta el número de caracteres que se piden para la transliteración. |
Dictionary lookup & example |
Se cuentan el número de caracteres enviados para la búsqueda de diccionario y los ejemplos. |
BreakSentence |
Sin cargo. |
Detect |
Sin cargo. |
Puntos de conexión de V3
Global
- api.cognitive.microsofttranslator.com
Métodos de traducción de texto de API V3
Compatibilidad y personalización
Nota
Microsoft Translator Hub se retirará el 17 de mayo de 2019. Ver información importante y fechas de migración.
Microsoft Translator V3 usa la traducción automática neuronal por defecto. Por lo tanto, no puede utilizarse con Microsoft Translator Hub. Translator Hub solo admite traducción automática estadística heredada. La personalización de la traducción neuronal está disponible si usa el Traductor personalizado. Obtenga más información sobre cómo personalizar la traducción automática neuronal
La traducción neuronal con Text API V3 no admite el uso de categorías estándar (SMT, voz, tech, generalnn).
| Versión | Punto de conexión | Compatible con el procesador GDPR | Utiliza Translator Hub | Utiliza Traductor personalizado (versión preliminar) |
|---|---|---|---|---|
| Translator versión 2 | api.microsofttranslator.com | No | Sí | No |
| Translator versión 3 | api.cognitive.microsofttranslator.com | Sí | No | Sí |
Translator versión 3
- Está disponible con carácter general y es totalmente compatible.
- Es compatible con GDPR como procesador y cumple todas las estipulaciones de ISO 20001 y 20018, así como los requisitos de certificación de SOC 3.
- Permite invocar los sistemas de traducción de redes neuronales que se han personalizado con Traductor personalizado (versión preliminar), la nueva característica de personalización de NMT de Translator.
- No proporciona acceso a los sistemas de traducción personalizada creados mediante Microsoft Translator Hub.
Si usa el punto de conexión api.cognitive.microsofttranslator.com, está utilizando la versión 3 de Translator.
Translator versión 2
- No cumple las ISO 20001, 20018 ni todos los requisitos de certificación de SOC 3.
- No permite invocar los sistemas de traducción de redes neuronales que se han personalizado con la característica de personalización de Translator.
- Proporciona acceso a los sistemas de traducción personalizada creados con Microsoft Translator Hub.
- Si usa el punto de conexión api.microsofttranslator.com, está utilizando la versión 2 de Translator.
Ninguna versión de Translator crea un registro de las traducciones. Las traducciones nunca se comparten con nadie. Obtenga más información en la página No hay rastro de Translator.
Vínculos
- Directiva de privacidad de Microsoft
- Información legal de Microsoft Azure
- Términos de Online Services.