Cloud Translation avanzado admite la traducción de texto mediante modelos de AutoML Translation personalizados y la creación de glosarios para garantizar que la API de Cloud Translation traduzca de manera correcta la terminología específica del dominio del cliente.
Si deseas usar modelos personalizados de AutoML para tu proyecto, debes habilitar la API de AutoML (automl.googleapis.com). Si deseas obtener instrucciones para instalar el SDK de Cloud, configurar un proyecto con una cuenta de servicio y obtener un token de acceso, consulta la página Configuración. Si planeas usar un glosario o las funciones por lotes, también necesitarás crear un bucket de Cloud Storage y otorgarle acceso a tu cuenta de servicio.
Antes de comenzar
Antes de comenzar a usar la API de Cloud Translation, debes tener un proyecto que tenga habilitada la API de Cloud Translation y las credenciales adecuadas. También puedes instalar bibliotecas cliente para los lenguajes de programación comunes que te ayudarán a realizar llamadas a la API.
Para obtener más información, consulta la página Configuración.
Compara modelos
Cuando solicitas una traducción de Cloud Translation Advanced, puedes especificar qué modelo de traducción se usará. Si no se especifica ningún modelo y se admite el par de idiomas, se usa el nmt
. De lo contrario, se usa el modelo PBMT.
Modelo | Uso adecuado | Ejemplos |
---|---|---|
Modelo de traducción automática neuronal (NMT) |
Casos prácticos de texto general como contenido de sitio web común no específico de un dominio, por ejemplo, artículos de noticias. |
Artículos de noticias, redes sociales, aplicaciones de chat, revisiones |
Modelo de traducción automática basada en frases (PBMT) | Por lo general, NMT produce traducciones de mejor calidad. El PBMT puede usarse de forma predeterminada si el modelo de NMT no existe para un par de idiomas. | Se usa cuando NMT no está disponible. |
Modelo de AutoML Translation | Texto específico del dominio. Los clientes proporcionan datos de entrenamiento específicos para sus casos prácticos, para pares de idiomas determinados a fin de personalizar el modelo base de Google para el propósito del dominio. | Noticias financieras, documentos técnicos y cualquier texto que use términos y jerga exclusiva de ese campo. |
Especifica el modelo de traducción con su ID. Para los modelos generales de Google, los ID de modelo son general/nmt
para el modelo de NMT y general/base
para el de PBMT. Consulta la siguiente sección para obtener información sobre los ID de modelo de AutoML Translation.
Traduce texto
El texto de entrada puede ser HTML o texto sin formato. La API de Cloud Translation no traduce ninguna etiqueta HTML en la entrada, solo el texto que aparece entre las etiquetas. El resultado conserva las etiquetas HTML (sin traducir), con el texto traducido entre las etiquetas en la medida de lo posible debido a las diferencias entre los idiomas de origen y objetivo. El orden de las etiquetas HTML en el resultado puede diferir del orden en el texto de entrada debido a los cambios en el orden de las palabras en la traducción.
Traduce strings de entrada
LÍNEA DE REST Y CMD
Si deseas traducir texto, realiza una solicitud POST
y proporciona código JSON en el cuerpo de la solicitud que identifique el idioma desde el que se traducirá (source_language_code
), el idioma al que se traducirá (target_language_code
) y el texto que se traducirá (contents
). Puedes proporcionar varias strings de texto para traducirlas si las incluyes en tu JSON (consulta el ejemplo). Identifica el idioma de origen y el idioma objetivo mediante los códigos ISO-639-1.
A continuación se muestra un ejemplo de una solicitud POST
mediante curl
o PowerShell. En el ejemplo, se usa el token de acceso correspondiente a la configuración de una cuenta de servicio para el proyecto mediante el SDK de Cloud de Google Cloud.
Si deseas obtener instrucciones para instalar el SDK de Cloud, configurar un proyecto con una cuenta de servicio y obtener un token de acceso, consulta la página Configuración.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- project-number-or-id: el número o ID de tu proyecto de Google Cloud
Método HTTP y URL:
POST https://translation.googleapis.com/v3/projects/project-number-or-id:translateText
Cuerpo JSON de la solicitud:
{ "sourceLanguageCode": "en", "targetLanguageCode": "ru", "contents": ["Dr. Watson, come here!", "Bring me some coffee!"] }
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://translation.googleapis.com/v3/projects/project-number-or-id:translateText
PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://translation.googleapis.com/v3/projects/project-number-or-id:translateText " | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "translations": [ { "translatedText": "Доктор Ватсон, иди сюда!", }, { "translatedText": "Принеси мне кофе!", } ] }
El arreglo translations
contiene dos campos translatedText
con traducciones proporcionadas en el idioma targetLanguageCode
solicitado (ru
: ruso). Las traducciones se indican en el mismo orden que el arreglo fuente correspondiente en la solicitud.
Comienza a usarlo
Antes de probar este código de muestra, sigue las instrucciones de configuración para Go que encontrarás en la guía de inicio rápido sobre las bibliotecas cliente de Translation. Si deseas obtener más información, consulta la documentación de referencia de la API de Translation para Go.
Java
Antes de probar este código de muestra, sigue las instrucciones de configuración para Java que encontrarás en la guía de inicio rápido sobre las bibliotecas cliente de Translation. Si deseas obtener más información, consulta la documentación de referencia de la API de Translation para Java.
Node.js
Antes de probar este código de muestra, sigue las instrucciones de configuración para Node.js que encontrarás en la guía de inicio rápido sobre las bibliotecas cliente de Translation. Si deseas obtener más información, consulta la documentación de referencia de la API de Translation para Node.js.
Python
Antes de probar este código de muestra, sigue las instrucciones de configuración para Python que encontrarás en la guía de inicio rápido sobre las bibliotecas cliente de Translation. Si deseas obtener más información, consulta la documentación de referencia de la API de Translation para Python.
Traduce textos con un modelo personalizado de AutoML Translation
LÍNEA DE REST Y CMD
En este ejemplo, se traduce un texto con un modelo de AutoML Translation cuyo ID de modelo es TRL1395675701985363739
. Puedes obtener el ID de un modelo de AutoML Translation de la lista de modelos en la IU de AutoML Translation o de la respuesta de la API cuando entrenas el modelo.
Antes de usar cualquiera de los siguientes datos de solicitud, realiza estos reemplazos:
- project-number-or-id: el número o ID de tu proyecto de Google Cloud
Método HTTP y URL:
POST https://translation.googleapis.com/v3/projects/project-number-or-id/locations/us-central1:translateText
Cuerpo JSON de la solicitud:
{ "model": "projects/project-number-or-id/locations/us-central1/models/TRL1395675701985363739", "sourceLanguageCode": "en", "targetLanguageCode": "ru", "contents": ["Dr. Watson, please discard your trash. You've shared unsolicited email with me. Let's talk about spam and importance ranking in a confidential mode."] }
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://translation.googleapis.com/v3/projects/project-number-or-id/locations/us-central1:translateText
PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://translation.googleapis.com/v3/projects/project-number-or-id/locations/us-central1:translateText " | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "translation": { "translatedText": "Доктор Ватсон, пожалуйста, откажитесь от своего мусора. Вы поделились нежелательной электронной почтой со мной. Давайте поговорим о спаме и важности рейтинга в конфиденциальном режиме.", "model": "projects/project-number/locations/us-central1/models/TRL1395675701985363739" } }
Comienza a usarlo
Antes de probar este código de muestra, sigue las instrucciones de configuración para Go que encontrarás en la guía de inicio rápido sobre las bibliotecas cliente de Translation. Si deseas obtener más información, consulta la documentación de referencia de la API de Translation para Go.
Java
Antes de probar este código de muestra, sigue las instrucciones de configuración para Java que encontrarás en la guía de inicio rápido sobre las bibliotecas cliente de Translation. Si deseas obtener más información, consulta la documentación de referencia de la API de Translation para Java.
Node.js
Antes de probar este código de muestra, sigue las instrucciones de configuración para Node.js que encontrarás en la guía de inicio rápido sobre las bibliotecas cliente de Translation. Si deseas obtener más información, consulta la documentación de referencia de la API de Translation para Node.js.
Python
Antes de probar este código de muestra, sigue las instrucciones de configuración para Python que encontrarás en la guía de inicio rápido sobre las bibliotecas cliente de Translation. Si deseas obtener más información, consulta la documentación de referencia de la API de Translation para Python.
Usa el parámetro del modelo
LÍNEA DE REST Y CMD
Puedes especificar qué modelo usar para la traducción mediante el parámetro de consulta model
. Especifica base
para usar el modelo de PBMT y nmt
si quieres usar el modelo NMT. Si especificas el modelo de NMT en tu solicitud y el par de idiomas de traducción solicitado no es compatible con el modelo de NMT, entonces se usa el modelo de PBMT.
En el siguiente ejemplo, se muestra cómo usar el parámetro model
en una solicitud de traducción y, además, se ilustra la selección de base
.
Antes de usar cualquiera de los siguientes datos de solicitud, realiza estos reemplazos:
- project-number-or-id: el número o ID de tu proyecto de Google Cloud
Método HTTP y URL:
POST https://translation.googleapis.com/v3/projects/project-number-or-id/locations/global:translateText
Cuerpo JSON de la solicitud:
{ "model": "projects/project-number-or-id/locations/global/models/general/base", "sourceLanguageCode": "en", "targetLanguageCode": "de", "contents": ["Come here!"] }
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://translation.googleapis.com/v3/projects/project-number-or-id/locations/global:translateText
PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://translation.googleapis.com/v3/projects/project-number-or-id/locations/global:translateText " | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "translations": [ { "translatedText": "Komm her!", "model": "projects/project-number/locations/global/models/general/base" } ] }