Descripción general de la API de Cloud Translation
La API de Cloud Translation puede traducir texto para más de 100 pares de idiomas. Si no sabes el idioma del texto fuente, la API de Cloud Translation puede detectarlo por ti. Para obtener una lista de todos los idiomas admitidos, consulta Idiomas admitidos.
Como organización empresarial, puedes incluir texto traducido en flujos de trabajo internos existentes. Por ejemplo, puedes tener un equipo de asistencia al cliente global que reciba casos de clientes en muchos idiomas diferentes. Puedes agregar la API de Cloud Translation a tu flujo de trabajo para traducir esos casos de clientes al idioma que hablan los miembros de tu equipo de asistencia al cliente. Con la API de Cloud Translation, mejoras la eficiencia general de tu equipo de asistencia al cliente, ya que no necesitan traducir el texto de forma manual ni confiar en otros.
La API de Cloud Translation se escala sin interrupciones y permite traducciones de caracteres ilimitadas por día. Sin embargo, existen restricciones para el tamaño del contenido de cada solicitud y los porcentajes de solicitudes. Además, puedes usar límites de cuotas para administrar tu presupuesto. Para obtener más información, consulta Cuotas y límites.
La API de Cloud Translation se ofrece en dos ediciones diferentes: una edición Basic y una edición Advanced. Para obtener una lista de las diferentes funciones compatibles con cada edición, consulta la comparación de ediciones.
API de Cloud Translation Basic
Se accede a la edición Basic a través de las bibliotecas cliente de la versión 2 y requiere una configuración mínima. Acepta claves de API para la autenticación, así como cuentas de servicio, y usa el modelo de traducción automática neuronal (NMT) preentrenado de Google sin modificaciones. Es una buena opción para las aplicaciones que necesitan traducir contenido informal generado por usuarios, como chats, redes sociales o comentarios.
De forma predeterminada, la API de Cloud Translation usa la edición Básica, que Google actualiza según una cadencia seminormal a medida que hay más datos de entrenamiento y mejores técnicas disponibles.
Sin embargo, si planeas un proyecto nuevo, te recomendamos que elijas la edición Advanced para aprovechar una mejor seguridad, más funciones y las nuevas mejoras del servicio que la edición Advanced seguirá implementando en el futuro.
API de Cloud Translation Advanced
Se accede a la edición Advanced a través de las bibliotecas cliente de la versión 3 y requiere la autenticación de la cuenta de servicio integrada con los roles de IAM. Ofrece una variedad de modelos, incluidos el modelo de LLM de Translation, el modelo de NMT y las personalizaciones de NMT. También proporciona funciones como glosarios, traducción por lotes, traducción de documentos y mucho más.
Las funciones clave de la API de Cloud Translation Advanced son las siguientes:
Acceso a más modelos: Elige el modelo adecuado para ti entre los modelos de traducción de vanguardia, como el LLM de Translation, el modelo de traducción automática neuronal (NMT) de Google, los modelos de traducción adaptativa o los modelos personalizados de NMT que tú o alguien más crearon.
Glosarios: Permiten crear un diccionario personalizado para traducir términos específicos del dominio de manera correcta y coherente.
Solicitudes por lotes: Permiten realizar solicitudes asíncronas para traducir grandes cantidades de texto.
Traducción de documentos: Traduce documentos, como archivos PDF, para conservar el formato y el diseño originales.
Roles de IAM: Para proteger tus solicitudes de traducción, usa Identity and Access Management. Para crear cuentas de servicio y otórgales permisos, usa roles de IAM. La API de Cloud Translation Advanced no admite claves de API.
Etiquetas: Agrega etiquetas definidas por el usuario (pares clave-valor) a tus solicitudes de traducción para realizar un mejor seguimiento del uso y obtener informes de facturación detallados.
Extremo regional: Controla dónde se almacenan y procesan los recursos de tu proyecto.
Glosarios
Un glosario es un diccionario personalizado que usa la API de Cloud Translation Avanzado para traducir de manera correcta y coherente términos específicos del dominio, entidades con nombre y otros tipos de términos que te son específicos. Por ejemplo, puedes usar un glosario para especificar una traducción específica para términos como "Google Summer of Code", "modo confidencial de Gmail" o "informe de rendimiento por posición".
También puedes usar los glosarios para evitar que se traduzcan ciertas palabras, como palabras prestadas o nombres de productos. Para obtener información sobre cómo usar glosarios, consulta Crea y usa glosarios.
Solicitudes por lotes
Las solicitudes de traducción por lotes son solicitudes asíncronas que traducen entradas del bucket de Cloud Storage. La API de Cloud Translation - Advanced realiza la traducción por lotes como una operación de larga duración y escribe el resultado en el bucket de Cloud Storage que especifiques. Las solicitudes intercaladas para la traducción por lotes no son compatibles.
Si deseas obtener información para realizar solicitudes por lotes, consulta Solicitudes por lotes (Avanzado).
Traducción de documentos
Traducción de documentos te permite traducir directamente documentos existentes, como archivos PDF y DOCX, a un idioma de destino. Traducción de documentos conserva el formato original para que los documentos traducidos tengan el mismo diseño y formato que los documentos originales. Por ejemplo, Traducción de documentos conserva los saltos de párrafo y los encabezados para que el contenido traducido se divida como en el documento original.
Las funciones de la API de Cloud Translation - Advanced, como los glosarios y los modelos de AutoML, también funcionan con Document Translation. Por ejemplo, si tienes un modelo de AutoML existente que usas para las traducciones de texto, puedes usar ese mismo modelo para Traducción de documentos. Para obtener más información sobre los tipos de archivo compatibles y cómo traducir documentos, consulta Traduce documentos.
Selección de modelos y modelos de AutoML
La selección de modelos de la API de Cloud Translation - Advanced te permite seleccionar de forma dinámica el modelo adecuado para tu aplicación entre el LLM de Translation (que también puedes personalizar aún más para las traducciones adaptativas), el modelo de NMT de Google o los modelos personalizados de AutoML Translation, según el contexto y el contenido que traduzcas.
Crea un modelo personalizado con AutoML Translation para obtener traducciones más precisas de la terminología específica del dominio. Luego, puedes usar el modelo resultante en la API de Cloud Translation Advanced para traducir texto.
Si deseas obtener información para usar modelos personalizados con el objetivo de traducir texto, consulta Traduce texto (Avanzado).
Funciones de IAM
La API de Cloud Translation - Advanced se integra con IAM para brindar seguridad adicional a tus solicitudes de traducción, habilitar el control de acceso detallado y admitir la integración con AutoML Translation.
Debes agregar usuarios y cuentas de servicio a uno de los siguientes roles para otorgar a esas cuentas acceso a la API de Cloud Translation Advanced. Si deseas obtener información para crear cuentas de servicio, consulta Crea y administra cuentas de servicio en la documentación de IAM.
| Rol | ID de la función | Descripción |
|---|---|---|
| Visualizador de API de Cloud Translation | roles/cloudtranslate.viewer |
Puede acceder a las operaciones get y list. |
| Usuario de la API de Cloud Translation | roles/cloudtranslate.user |
Incluye los permisos de |
| Editor de la API de Cloud Translation | roles/cloudtranslate.editor |
Incluye los permisos de |
| Administrador de la API de Cloud Translation | roles/cloudtranslate.admin |
Incluye los permisos de |
Para ver una lista de los permisos que contiene cada rol, consulta Información sobre los roles.
Estas funciones preconfiguradas abordan muchos casos prácticos. Sin embargo, es posible que necesites un rol que incluya un conjunto personalizado de permisos. Por ejemplo, es posible que desees crear un rol que permita a un usuario generar un glosario en un proyecto, sin permitir que borre o actualice los glosarios existentes en el proyecto. En esos casos, puedes crear un rol personalizado de IAM que satisfaga tus necesidades.
Si deseas obtener información para administrar roles de IAM, consulta Otorga, cambia y revoca el acceso a los recursos y Asigna roles a cuentas de servicio.
Etiquetas
La API de Cloud Translation - Advanced admite la adición de etiquetas definidas por el usuario (pares clave-valor) a las solicitudes TranslateText, BatchTranslateText y DetectLanguage.
La información sobre el uso de una solicitud se envía al sistema de facturación, en el
que puedes desglosar los cargos de facturación con filtros basados en tus etiquetas.
Para obtener más información sobre las etiquetas definidas por el usuario, consulta Informa el uso con etiquetas (Avanzado).
Extremo regional
De forma predeterminada, la API de Cloud Translation Avanzado almacena y procesa recursos en una ubicación global, lo que significa que no existe garantía de recursos dentro de una ubicación en particular. En lugar de usar el extremo global predeterminado, puedes usar un extremo regional para mantener los recursos dentro de una ubicación en particular, como la Unión Europea. Para obtener más información, consulta Especifica un extremo regional.
Comparación de edición
En la siguiente tabla, se muestran las funciones que están disponibles en cada edición.
| Función | Básico | Avanzado |
|---|---|---|
| Traducción con el modelo de NMT | ||
| Traducción con el LLM de Translation | ||
| Traducción con modelos de traducción adaptable | ||
| Traducción con modelos personalizados | ||
| Traducción de varias cadenas en una sola solicitud | ||
| Traducciones por lotes con Cloud Storage | ||
| Traduce documentos | ||
| Compatibilidad con glosarios (controla la terminología) | ||
| Entrenamiento de modelos personalizados | ||
| Reconocimiento de idioma | ||
| API de REST integrada | ||
| API de gRPC integrada | ||
| Cuenta de servicio | ||
| Clave de API | ||
| Registro de auditoría | ||
| Admite HTML | ||
| Admite más de 100 idiomas | ||
| Compatibilidad con la latinización | ||
| Compatibilidad con la transliteración | ||
| Traducción adaptable | ||
| Compatibilidad con extremos multirregionales | ||
| Compatibilidad con los Controles del servicio de VPC |
Consulta las funciones de la API de Cloud Translation Advanced para obtener más detalles sobre esta API.
Precios
La API de Cloud Translation te cobra mensualmente según la cantidad de caracteres que envías. Para obtener más información, consulta Precios.
Recursos y lecturas adicionales
- Para comenzar a usar la API, configúrala y, luego, prueba la guía de inicio rápido.
- Compara los modelos compatibles
- Personaliza el modelo de NMT
- Cómo personalizar el LLM de Translation
- Idiomas admitidos
- Formatos admitidos
- Realiza una traducción adaptable
- Migra a Translation Advanced
- Para obtener respuestas a preguntas generales sobre la API de Cloud Translation, consulta la página de Preguntas frecuentes generales.