Descripción general de la API Cloud Translation
La API Cloud Translation puede traducir texto a más de 100 pares de idiomas. Si no sabes el idioma del texto de origen, la API Cloud Translation puede detectarlo por ti. Para ver una lista de todos los idiomas admitidos, consulta Idiomas admitidos.
Si tu organización es una empresa, puedes incluir texto traducido en los flujos de trabajo internos que ya tengas. Por ejemplo, puede que tengas un equipo de asistencia global que reciba casos de clientes en muchos idiomas diferentes. Puedes añadir la API Cloud Translation a tu flujo de trabajo para traducir esos casos de clientes al idioma que hablen los miembros de tu equipo de asistencia. Al usar la API Cloud Translation, mejoras la eficiencia general de tu equipo de asistencia, ya que no tiene que traducir texto manualmente ni depender de otros.
La API Cloud Translation se escala sin problemas y permite traducir un número ilimitado de caracteres al día. Sin embargo, hay restricciones en el tamaño del contenido de cada solicitud y en las frecuencias de las solicitudes. Además, puedes usar los límites de cuota para gestionar tu presupuesto. Para obtener más información, consulta la página Cuotas y límites.
La API Cloud Translation está disponible en dos ediciones diferentes: la básica y la avanzada. Para ver una lista de las diferentes funciones admitidas por cada edición, consulta la comparativa de ediciones.
API Cloud Translation - Basic
Se accede a la edición Basic a través de las bibliotecas de 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 Cloud Translation usa la edición Basic, que Google actualiza de forma periódica a medida que se dispone de más datos de entrenamiento y mejores técnicas.
Sin embargo, si estás planeando un nuevo proyecto, te recomendamos que elijas la edición Advanced para disfrutar de una mayor seguridad, más funciones y las nuevas mejoras del servicio que se irán implementando en esta edición.
API Cloud Translation - Advanced
Se accede a la edición Advanced a través de las bibliotecas de cliente de la versión 3 y requiere la autenticación de la cuenta de servicio integrada con los roles de gestión de identidades y accesos. Ofrece una selección de modelos, como el modelo LLM de traducción, el modelo NMT y las personalizaciones de NMT. También ofrece funciones como glosarios, traducción por lotes, traducción de documentos y más.
Las principales características de la API Cloud Translation Advanced son las siguientes:
Acceso a más modelos: elige el modelo que mejor se adapte a tus necesidades entre los modelos de traducción más avanzados, como el modelo LLM de traducción, el modelo de traducción automática neuronal (NMT) de Google, los modelos de traducción adaptativa o los modelos NMT personalizados que hayas creado tú u otra persona.
Glosarios: crea un diccionario personalizado para traducir de forma correcta y coherente los términos específicos de un dominio.
Solicitudes por lotes: haz 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 gestión de identidades y accesos: protege tus solicitudes de traducción con Gestión de identidades y accesos. Crea cuentas de servicio y concédeles permisos añadiendo roles de IAM. La API Cloud Translation - Advanced no admite claves de API.
Etiquetas: añade etiquetas definidas por el usuario (pares clave-valor) a tus solicitudes de traducción para hacer un mejor seguimiento del uso y obtener informes de facturación detallados.
Endpoint regional: controla dónde se almacenan y procesan los recursos de tu proyecto.
Glosarios
Un glosario es un diccionario personalizado que usa la API Cloud Translation - Advanced para traducir de forma correcta y coherente términos específicos de un dominio, entidades con nombre y otros tipos de términos que son específicos para ti. Por ejemplo, puedes usar un glosario para especificar una traducción concreta de términos como "Google Summer of Code", "modo confidencial de Gmail" o "informe de rendimiento de emplazamiento".
También puedes usar glosarios para evitar que se traduzcan determinadas palabras, como palabras tomadas de otros idiomas o nombres de productos. Para obtener información sobre cómo usar glosarios, consulta el artículo Crear y usar glosarios.
Solicitudes en lote
Las solicitudes de traducción por lotes son solicitudes asíncronas que traducen la entrada de los segmentos de Cloud Storage. La API Cloud Translation Advanced realiza la traducción por lotes como una operación de larga duración y escribe el resultado en un segmento de Cloud Storage que especifiques. No se admiten solicitudes insertadas de traducción por lotes.
Para obtener información sobre cómo crear solicitudes por lotes, consulta Solicitudes por lotes (avanzado).
Traducción de documentos
Document Translation te permite traducir directamente documentos, 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 originales. Por ejemplo, Traducción de documentos conserva los saltos de párrafo y los encabezados para que el contenido traducido se divida igual que en el documento original.
Las funciones de la API 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 que usas para traducir texto, puedes usarlo también para traducir documentos. Para obtener más información sobre los tipos de archivo admitidos y cómo traducir documentos, consulta el artículo Traducir documentos.
Selección de modelos y modelos de AutoML
La selección de modelos de la API Cloud Translation - Advanced te permite elegir dinámicamente el modelo adecuado para tu aplicación entre el LLM de traducción (que también puedes personalizar para adaptarlo a tus traducciones), el modelo de traducción automática neuronal de Google o los modelos de AutoML Translation personalizados, en función del contexto y del contenido que estés traduciendo.
Crea un modelo personalizado con AutoML Translation para obtener traducciones más precisas de la terminología específica de un dominio. Después, puedes usar el modelo resultante en la API Cloud Translation - Advanced para traducir texto.
Para obtener información sobre cómo usar modelos personalizados para traducir texto, consulta el artículo Traducir texto (avanzado).
Roles de gestión de identidades y accesos
La API Cloud Translation - Advanced se integra con IAM para proporcionar seguridad adicional a tus solicitudes de traducción, habilitar un control de acceso detallado y admitir la integración con AutoML Translation.
Para conceder acceso a la API Cloud Translation - Advanced a los usuarios y las cuentas de servicio, debes añadirlos a uno de los siguientes roles. Para obtener información sobre cómo crear cuentas de servicio, consulta el artículo Crear y gestionar cuentas de servicio de la documentación de IAM.
| Rol | ID de rol | Descripción |
|---|---|---|
| Lector de la API de Cloud Translation | roles/cloudtranslate.viewer |
Puede acceder a las operaciones de obtención y lista. |
| Usuario de la API 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 Cloud Translation | roles/cloudtranslate.admin |
Incluye los permisos de |
Para ver una lista de los permisos que contiene cada rol, consulta el artículo Descripción de roles.
Estos roles preconfigurados se adaptan a muchos casos prácticos habituales. Sin embargo, es posible que necesites un rol que incluya un conjunto personalizado de permisos. Por ejemplo, puede que quieras crear un rol que permita a un usuario crear un glosario en un proyecto, pero no eliminar ni actualizar los glosarios que ya haya en el proyecto. En esos casos, puedes crear un rol personalizado de gestión de identidades y accesos que se ajuste a tus necesidades.
Para obtener información sobre cómo gestionar los roles de gestión de identidades y accesos, consulta los artículos Conceder, cambiar y revocar el acceso a los recursos y Conceder roles a cuentas de servicio.
Etiquetas
La API Cloud Translation Advanced permite añadir 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 reenvía al sistema de facturación, donde puedes desglosar los cargos de facturación filtrando por etiquetas.
Para obtener más información sobre las etiquetas definidas por el usuario, consulta el artículo Informes de uso con etiquetas (avanzado).
Punto de conexión regional
De forma predeterminada, la API Cloud Translation - Advanced almacena y procesa recursos en una ubicación global, lo que significa que no hay ninguna garantía de que los recursos permanezcan en una ubicación concreta. En lugar de usar el endpoint global predeterminado, puedes usar un endpoint regional para mantener los recursos en una ubicación concreta, como la Unión Europea. Para obtener más información, consulte Especificar un endpoint regional.
Comparación de ediciones
En la siguiente tabla se muestran las funciones disponibles en cada edición.
| Función | Básica | Avanzado |
|---|---|---|
| Traducir con el modelo de NMT | ||
| Traducir con el LLM de traducción | ||
| Traducir con modelos de traducción adaptables | ||
| Traducción con modelos personalizados | ||
| Traducir varias cadenas en una sola solicitud | ||
| Traducciones por lotes con Cloud Storage | ||
| Traducir documentos | ||
| Compatibilidad con glosarios (terminología de control) | ||
| Preparación de modelos personalizados | ||
| Detección de idioma | ||
| API REST integrada | ||
| API gRPC integrada | ||
| Cuenta de servicio | ||
| Clave de API | ||
| Registros de auditoría | ||
| Compatible con HTML | ||
| Compatible con más de 100 idiomas | ||
| Compatibilidad con la romanización | ||
| Compatibilidad con transliteración | ||
| Traducción adaptable | ||
| Compatibilidad con endpoints multirregionales | ||
| Compatible con los Controles de Servicio de VPC |
Consulta más información sobre la API Cloud Translation - Advanced en el artículo Características avanzadas de la API Cloud Translation.
Precios
La API Cloud Translation te cobra mensualmente en función del número de caracteres que envíes. Para obtener más información, consulta los precios.
Recursos y lecturas adicionales
- Para empezar a usar la API, configúrala y, después, consulta la guía de inicio rápido.
- Comparar modelos compatibles
- Personalizar el modelo de TNM
- Personalizar el LLM de traducción
- Idiomas admitidos
- Formatos admitidos
- Realizar una traducción adaptativa
- Migrar a Translation Advanced
- Para obtener respuestas a preguntas generales sobre la API Cloud Translation, consulta la página de preguntas frecuentes generales.