La edición Advanced de Cloud Translation se ha optimizado para casos prácticos de personalización y contenido extenso. Además del modelo de traducción automática neuronal (NMT), la edición Advanced te da acceso al modelo LLM de traducción (el modelo de traducción de estilo LLM más reciente y de mayor calidad de Google) y te permite crear modelos personalizados.
Cloud Translation - Advanced también ofrece funciones avanzadas de traducción de texto, como la traducción de documentos y la creación de glosarios, para asegurarse de que la terminología específica de tu dominio se traduce correctamente.
Antes de empezar
Para empezar a usar la API Cloud Translation, debes tener un proyecto en el que esté habilitada la API Cloud Translation y las credenciales adecuadas. También puedes instalar bibliotecas de cliente de los lenguajes de programación comunes para ayudarte a hacer llamadas a la API. Para obtener más información, consulta la página Configuración.
Para obtener instrucciones sobre cómo instalar la CLI de Google Cloud, configurar un proyecto con una cuenta de servicio y obtener un token de acceso, consulta la página Configuración. Si tienes previsto usar un glosario o las funciones por lotes, también debes crear un segmento de Cloud Storage y conceder acceso a tu cuenta de servicio.
Traducir texto
En el caso de las traducciones, la entrada puede ser texto sin formato o HTML. La API Cloud Translation no traduce ninguna etiqueta HTML de la entrada, solo el texto que aparece entre las etiquetas. El resultado conserva las etiquetas HTML (sin traducir) y el texto traducido entre las etiquetas en la medida de lo posible debido a las diferencias entre los idiomas de origen y de destino.
Traducir cadenas de entrada
REST
Para traducir texto, haz una solicitud POST
y proporciona un archivo JSON en el cuerpo de la solicitud que identifique el idioma de origen (source_language_code
), el idioma de destino (target_language_code
) y el texto que quieras traducir (contents
). Puedes proporcionar varias cadenas de texto para traducir incluyéndolas en tu archivo JSON (consulta el ejemplo). Para identificar los idiomas de origen y de destino, utiliza sus códigos ISO-639.
A continuación, se muestra un ejemplo de una solicitud POST
que utiliza curl
o PowerShell. En el ejemplo se usa el token de acceso de una cuenta de servicio configurada para el proyecto con la Google Cloud
CLI de Google Cloud.
Para obtener instrucciones sobre cómo instalar la CLI de Google Cloud, configurar un proyecto con una cuenta de servicio y obtener un token de acceso, consulta la página Configuración.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- PROJECT_NUMBER_OR_ID: el ID numérico o alfanumérico de tu Google Cloud proyecto
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, despliega una de estas opciones:
Deberías recibir una respuesta JSON similar a la siguiente:
{ "translations": [ { "translatedText": "Доктор Ватсон, иди сюда!", }, { "translatedText": "Принеси мне кофе!", } ] }
La matriz translations
contiene dos campos translatedText
con traducciones
proporcionadas en el idioma targetLanguageCode
solicitado (ru
: ruso). Las traducciones se muestran en el mismo orden que la matriz de origen correspondiente en la solicitud.
Go
Antes de probar este ejemplo, sigue las Go instrucciones de configuración de la guía de inicio rápido de Cloud Translation con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Go Cloud Translation.
Para autenticarte en Cloud Translation, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Java
Antes de probar este ejemplo, sigue las Java instrucciones de configuración de la guía de inicio rápido de Cloud Translation con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Java Cloud Translation.
Para autenticarte en Cloud Translation, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Node.js
Antes de probar este ejemplo, sigue las Node.js instrucciones de configuración de la guía de inicio rápido de Cloud Translation con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Node.js Cloud Translation.
Para autenticarte en Cloud Translation, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Python
Antes de probar este ejemplo, sigue las Python instrucciones de configuración de la guía de inicio rápido de Cloud Translation con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Python Cloud Translation.
Para autenticarte en Cloud Translation, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Idiomas adicionales
C#: Sigue las instrucciones de configuración de C# en la página de bibliotecas de cliente y, a continuación, consulta la documentación de referencia de Cloud Translation para .NET.
PHP Sigue las instrucciones de configuración de PHP en la página de bibliotecas de cliente y, a continuación, consulta la documentación de referencia de Cloud Translation para PHP.
Ruby: Sigue las instrucciones de configuración de Ruby en la página de bibliotecas de cliente y, a continuación, consulta la documentación de referencia de Cloud Translation para Ruby.
Traducir texto con un modelo específico
REST
Puede especificar qué modelo quiere usar para la traducción mediante el parámetro de consulta model
.
En el siguiente ejemplo se traduce texto mediante un modelo personalizado con el ID 1395675701985363739
. Puedes obtener el ID de un modelo personalizado de la lista de modelos de la Google Cloud consola o de la respuesta de la API, o bien en la página de Pantheon correspondiente cuando entrenes el modelo. Para usar el LLM de traducción, especifica general/translation-llm
como ID de modelo. Para usar el LLM de traducción personalizado (vista previa pública), especifica model/translation-llm-custom/{model-id}
como ID de modelo.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- PROJECT_ID: tu ID de proyecto Google Cloud .
- LOCATION: la región en la que se encuentra el modelo personalizado, como
us-central1
.
Método HTTP y URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText
Cuerpo JSON de la solicitud:
{ "model": "projects/PROJECT_ID/locations/LOCATION/models/1395675701985363739", "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 print-access-token)" \
-H "x-goog-user-project: PROJECT_ID" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText"
PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la siguiente:
{ "translation": { "translatedText": "Доктор Ватсон, пожалуйста, откажитесь от своего мусора. Вы поделились нежелательной электронной почтой со мной. Давайте поговорим о спаме и важности рейтинга в конфиденциальном режиме.", "model": "projects/PROJECT_NUMBER/locations/LOCATION/models/1395675701985363739" } }
Go
Antes de probar este ejemplo, sigue las Go instrucciones de configuración de la guía de inicio rápido de Cloud Translation con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Go Cloud Translation.
Para autenticarte en Cloud Translation, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Java
Antes de probar este ejemplo, sigue las Java instrucciones de configuración de la guía de inicio rápido de Cloud Translation con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Java Cloud Translation.
Para autenticarte en Cloud Translation, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Node.js
Antes de probar este ejemplo, sigue las Node.js instrucciones de configuración de la guía de inicio rápido de Cloud Translation con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Node.js Cloud Translation.
Para autenticarte en Cloud Translation, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Python
Antes de probar este ejemplo, sigue las Python instrucciones de configuración de la guía de inicio rápido de Cloud Translation con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Python Cloud Translation.
Para autenticarte en Cloud Translation, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Idiomas adicionales
C#: Sigue las instrucciones de configuración de C# en la página de bibliotecas de cliente y, a continuación, consulta la documentación de referencia de Cloud Translation para .NET.
PHP Sigue las instrucciones de configuración de PHP en la página de bibliotecas de cliente y, a continuación, consulta la documentación de referencia de Cloud Translation para PHP.
Ruby: Sigue las instrucciones de configuración de Ruby en la página de bibliotecas de cliente y, a continuación, consulta la documentación de referencia de Cloud Translation para Ruby.
Transliteración
La transliteración es un ajuste de configuración del método translateText
. Cuando habilitas la transliteración, traduces texto romanizado (alfabeto latino) directamente al idioma de destino. Por ejemplo, puedes traducir texto japonés romanizado directamente al inglés, al español o al chino. Las traducciones resultantes están en el sistema de escritura del idioma de destino.
En tus solicitudes de transliteración, incluye solo texto romanizado. Si combinas texto romanizado con texto no romanizado, Cloud Translation no puede garantizar traducciones coherentes y correctas.
Cuestiones importantes
La transliteración se diferencia de las traducciones de texto estándar en los siguientes aspectos:
- La transliteración solo está disponible en algunos idiomas. Para obtener más información, consulta la columna Transliteración de la página Idiomas admitidos.
- El tipo MIME debe ser
text/plain
. No se admite HTML. - La transliteración solo es compatible con el modelo estándar predeterminado. No se admiten modelos personalizados.
- La transliteración tiene una cuota de contenido predeterminada inferior. Para obtener más información, consulta Cuotas y límites.
REST
Define el campo transliteration_config
en el método
translateText
.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- PROJECT_NUMBER_OR_ID: el ID numérico o alfanumérico de tu proyecto de Google Cloud .
- LOCATION: región en la que quieres ejecutar esta operación. Por ejemplo,
us-central1
. - SOURCE_LANGUAGE: (opcional) código de idioma del texto de entrada. Si lo conoces, asigna uno de los códigos de idioma que se indican en Idiomas admitidos.
- TARGET_LANGUAGE: el idioma de destino al que se traducirá el texto de entrada. Se define en uno de los códigos de idioma que se indican en Idiomas admitidos.
- SOURCE_TEXT: texto romanizado en el idioma de origen que se va a traducir.
Método HTTP y URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText
Cuerpo JSON de la solicitud:
{ "source_language_code": "SOURCE_LANGUAGE", "target_language_code": "TARGET_LANGUAGE", "contents": "SOURCE_TEXT", "mime_type": "text/plain", "transliteration_config": { "enable_transliteration": true} }
Para enviar tu solicitud, despliega una de estas opciones:
Deberías recibir una respuesta JSON similar a la siguiente:
{ "translations": [ { "translatedText": "TRANSLATED_TEXT", } ] }
Recursos adicionales
- Para obtener ayuda sobre cómo resolver problemas o errores habituales, consulta la página Solución de problemas.