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.
Ediciones y modelos de la API de Cloud Translation
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.
Te ofrece una variedad de modelos para que elijas el que mejor se adapte a tu aplicación en particular.
API de Cloud Translation Basic
Se accede a la edición Basic a través de las bibliotecas cliente de la versión 2, requiere una configuración mínima y acepta claves de API para la autenticación, así como cuentas de servicio. Solo brinda acceso al modelo de traducción automática neuronal (NMT) 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.
Si planeas un proyecto nuevo, te recomendamos que elijas la edición Advanced en lugar de la Basic 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, incluido el modelo de LLM de Translation (TLLM) más reciente, así como el modelo de NMT con y sin personalización. También ofrece funciones como glosarios, traducción por lotes, traducción de documentos y mucho más:
Glosarios: Un glosario es un diccionario personalizado que creas para traducir términos específicos del dominio de manera correcta y coherente.
Solicitudes por lotes: Las solicitudes por lotes te permiten realizar solicitudes asíncronas que traducen grandes cantidades de texto.
Traducción de documentos: Esta función te permite traducir documentos, como archivos PDF, y conservar su formato y diseño originales.
Roles de IAM: Los roles de IAM te permiten proteger tus solicitudes de traducción a través de Identity and Access Management. Puedes crear cuentas de servicio y otorgarles permisos con roles de IAM. Ten en cuenta que la API de Cloud Translation Avanzado no admite claves de API.
Etiquetas: Puedes agregar etiquetas definidas por el usuario (pares clave-valor) a tus solicitudes de traducción para hacer un seguimiento del uso y habilitar informes de facturación detallados.
Extremo regional: Con un extremo regional, puedes controlar dónde se almacenan y procesan los recursos de tu proyecto.
Funciones avanzadas de la API
Usar la API de Cloud Translation - Advanced en lugar de la API de Cloud Translation - Basic te brinda acceso a las siguientes funciones que pueden hacer que tu solución de traducción sea más sólida y adecuada para tu caso de uso específico:
Selección y personalización de modelos
La selección del modelo de la API de Cloud Translation Avanzada te permite seleccionar de forma dinámica diferentes modelos, incluidos los que personalizas para que se adapten a tu aplicación en particular.
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 de buckets 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 un bucket de Cloud Storage que especifiques. Las solicitudes intercaladas para la traducción por lotes no son compatibles.
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 de la misma manera que en el documento original.
Las funciones de la API de Cloud Translation - Advanced, como los glosarios y los modelos de NMT personalizados, también funcionan con la traducción de documentos. Por ejemplo, si ya tienes un modelo de NMT personalizado que usas para las traducciones de texto, puedes usar ese mismo modelo para la Traducción de documentos. Para obtener más información sobre los tipos de archivo compatibles y cómo traducir documentos, consulta Traduce documentos.
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 modelos personalizados de NMT.
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.