Traduce texto
En esta página, se muestra cómo traducir texto de muestra con las ediciones Basic y Advanced de Cloud Translation. Te brindan acceso al modelo estándar de traducción automática neuronal (NMT) y al LLM de Translation, que es nuestro modelo de traducción de estilo LLM más reciente.
La API de Cloud Translation - Basic proporciona acceso inmediato y directo a estos modelos. Por otro lado, Cloud Translation - Advanced está optimizado para casos de uso de contenido con formato largo y personalización. Para ver un ejemplo de código, consulta el ejemplo de traducción de texto avanzada. En situaciones especiales, también puedes usar Cloud Translation - Advanced para crear modelos personalizados.
Cloud Translation Avanzado también proporciona capacidades avanzadas de traducción de texto, como la traducción de documentos y la creación de glosarios, para garantizar que la terminología específica de tu dominio se traduzca de forma correcta.
Antes de comenzar
Antes de comenzar a usar la API de Cloud Translation, debes completar la página de configuración de Cloud Translation, que incluye la creación de un proyecto, la habilitación de la API de Cloud Translation y la configuración de la autenticación. La página de configuración también proporciona instrucciones para instalar bibliotecas cliente para lenguajes de programación comunes, lo que es opcional.
LLM de Translation con la API de Cloud Translation Basic
Para usar el modelo Translation LLM estándar en la API de Cloud Translation Basic, pasa su nombre completo del recurso en el parámetro model.
curl -X POST \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
"q": ["The old lighthouse stood on the edge of the cliff."],
"target": "es",
"model": "projects/PROJECT_ID/locations/REGION_NAME/models/general/translation-llm"
}' \
"https://translation.googleapis.com/language/translate/v2?key=YOUR_API_KEY"
La API de Cloud Translation Básico solo admite modelos estándar de NMT y LLM, no modelos personalizados. Para usar un modelo personalizado o cualquier otra función avanzada, como la traducción de documentos o los glosarios, usa Cloud Translation - Advanced. Para obtener más información sobre cómo llamar a la API básica, consulta el ejemplo de traducción de texto básica.
Traducción de texto avanzada
Para las traducciones con Cloud Translation Advanced, la 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.
Ejemplo avanzado de traducción de texto
REST
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 cadenas de texto para traducirlas si las incluyes en tu JSON (consulta el ejemplo). Identifica tus idiomas de origen y de destino con sus códigos ISO-639.
A continuación se muestra un ejemplo de una solicitud POST con 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 con la Google Cloud CLI de Google Cloud.
Si deseas obtener instrucciones para instalar Google Cloud CLI, 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, realiza los siguientes reemplazos:
- PROJECT_NUMBER_OR_ID: Es el ID numérico o alfanumérico 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, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{
"translations": [
{
"translatedText": "Доктор Ватсон, иди сюда!",
},
{
"translatedText": "Принеси мне кофе!",
}
]
}
El array 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.
Go
Antes de probar este ejemplo, sigue las instrucciones de configuración para Go que encontrarás en la guía de inicio rápido de Cloud Translation sobre las bibliotecas cliente. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Translation para Go.
Para autenticarte en Cloud Translation, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración para Java que encontrarás en la guía de inicio rápido de Cloud Translation sobre las bibliotecas cliente. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Translation para Java.
Para autenticarte en Cloud Translation, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js que encontrarás en la guía de inicio rápido de Cloud Translation sobre las bibliotecas cliente. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Translation para Node.js.
Para autenticarte en Cloud Translation, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Antes de probar este ejemplo, sigue las instrucciones de configuración para Python que encontrarás en la guía de inicio rápido de Cloud Translation sobre las bibliotecas cliente. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Translation para Python.
Para autenticarte en Cloud Translation, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.