Esta página es una traducción automática de la página en inglés, que es la versión de referencia. Leer la página en inglés
Traducir publicaciones con un servicio de traducción
El servidor puede traducir una publicación cuando un lector lo pide, a través de un servicio de traducción que tú configuras: LibreTranslate,
DeepL, Google Cloud Translation o Amazon Translate. Un proveedor queda incorporado cuando el servidor tiene sus claves, y la
configuración de la instancia translation_providers lo activa.
LibreTranslate
Sección titulada «LibreTranslate»LibreTranslate es una traducción automática de código abierto que puedes ejecutar tú mismo o usar como servicio alojado en libretranslate.com. Apunta el servidor hacia él con dos valores de configuración de la configuración:
MY_TRANSLATOR_LIBRETRANSLATE_URL=http://libretranslate:5000# Only when the server asks for a key, as libretranslate.com does:MY_TRANSLATOR_LIBRETRANSLATE_API_KEY=your-keytranslator_libretranslate_urles la URL base del servidor de LibreTranslate, conhttp:ohttps:y una ruta opcional. Funciona un servidor en una dirección privada, como un contenedor junto a este ohttp://10.0.0.5:5000. El servidor no sigue las redirecciones que este devuelva, así que la clave no va a ningún otro sitio.translator_libretranslate_api_keyes un secreto que se lee solo del entorno (MY_TRANSLATOR_LIBRETRANSLATE_API_KEYoMY_TRANSLATOR_LIBRETRANSLATE_API_KEY_FILE). Déjalo sin definir cuando el servidor no necesite clave; uno que alojes tú casi nunca la necesita. La clave nunca se muestra a los clientes ni se escribe en los registros.
Después añade libretranslate a la configuración de la instancia translation_providers, en el orden en que quieras que se pruebe, por ejemplo
translation_providers = libretranslate solo, o seguido del ID de otro proveedor para recurrir a él.
El servidor pide a LibreTranslate su lista de idiomas antes de la primera traducción y de nuevo cada hora, y no envía una publicación en un par de idiomas que no figure en ella. Cuando una publicación no tiene idioma, LibreTranslate lo detecta. En un servidor que ejecutes tú, instala los modelos de idioma que necesiten tus lectores.
La calidad de la traducción varía según el idioma. Los modelos de LibreTranslate son buenos para algunos pares y mediocres para otros,
y una traducción desde un idioma con pocos datos de entrenamiento puede perder el sentido. Prueba los idiomas que usa tu
comunidad antes de activarlo, y deja un proveedor comercial después de él en translation_providers si lo necesitas.
Adónde va el texto. Un servidor que ejecutas tú guarda el texto de las publicaciones en tus propias máquinas y nadie más
lo recibe. Entonces puedes permitirle publicaciones private y direct con translation_provider_visibilities, por ejemplo
libretranslate=public|local|unlisted|private|direct, y la
política de privacidad no cita ningún servicio externo de traducción. Un
LibreTranslate alojado, libretranslate.com o el de otra persona, recibe el texto como cualquier otro proveedor: lee sus condiciones, mantén las
visibilidades predeterminadas y nómbralo en la política.
DeepL traduce a través de su API con una clave de un plan de API de DeepL. El servidor envía el texto de una publicación con los marcadores que sustituyen a menciones, enlaces y formato como elementos XML, que DeepL mantiene en su sitio, y nada más de la publicación.
-
Obtén una clave de autenticación en tu cuenta de DeepL. Una clave del plan gratuito termina en
:fx. -
Defínela en la configuración del despliegue y reinicia el servidor:
Ventana de terminal MY_TRANSLATOR_DEEPL_API_KEY=your-keyEl servidor llama a
https://api-free.deepl.compara una clave del plan gratuito y ahttps://api.deepl.compara cualquier otra. Para pasar por un proxy, defineMY_TRANSLATOR_DEEPL_URL. La clave es un secreto: el servidor nunca la registra, la incluye en un error ni la muestra en un ajuste o en una respuesta de la API de cliente, y la envía solo a esa dirección, sin seguir redirecciones. -
Activa el proveedor con la configuración de la instancia
translation_providers, solo o en tu orden:Ventana de terminal my instance set translation_providers deepl
El servidor pregunta a DeepL qué idiomas traduce la primera vez que traduce, y de nuevo cada día. El idioma de una publicación
pasa a la variante más cercana que tenga DeepL: el inglés a en-US, el portugués a pt-BR, el chino de Taiwán a zh-Hant. Un
idioma que DeepL no tiene pasa al siguiente proveedor, o se informa al lector de que no se puede traducir.
Cuota. Cada plan tiene una cuota mensual de caracteres, y un plan de pago puede tener un límite de costo que fijas en tu cuenta
de DeepL. Cuando DeepL informa de la cuota o de su límite de frecuencia, el servidor prueba el siguiente proveedor de translation_providers.
Si no queda ninguno, el lector ve que la publicación no se pudo traducir en este momento, y el cliente web usa la traducción
del navegador si lo permites. Los límites mensuales del propio servidor (translation_user_monthly_characters y
translation_server_monthly_characters) se aplican antes de cualquier llamada, así que fíjalos por debajo de tu cuota de DeepL. DeepL puede contar los
caracteres de forma distinta.
Datos. Lee las condiciones de DeepL antes de activarlo:
- En un plan de pago, DeepL conserva el texto y las traducciones solo el tiempo que necesita para traducirlos, y como máximo 72 horas cuando investiga un error.
- En el plan gratuito, DeepL puede conservar el texto y las traducciones para siempre, y sus condiciones prohíben enviar datos personales
a través de él. Las publicaciones suelen contener datos personales, así que usa el plan gratuito solo para probar el proveedor. No le permitas nunca
publicaciones
privateodirectentranslation_provider_visibilities, y di en tu política de privacidad que DeepL conserva lo que recibe.
En un plan de pago puedes permitir publicaciones private y direct, proveedor por proveedor:
my instance set translation_provider_visibilities 'deepl=public|local|unlisted|private'Atribución. Las condiciones de DeepL exigen que su nombre o logotipo se muestre con cada traducción. El cliente web muestra
«DeepL» con un enlace a https://www.deepl.com junto a cada traducción suya, así que no tienes que añadir nada.
Google Cloud Translation
Sección titulada «Google Cloud Translation»Cloud Translation tiene el ID de proveedor google. El servidor llama a su
método TranslateText con el modelo de traducción general, y envía el texto como HTML para que las menciones, los enlaces y
las demás partes que deben quedar como están vuelvan en su sitio.
- Activa la API de Cloud Translation (
translate.googleapis.com) en el proyecto que paga las traducciones:gcloud services enable translate.googleapis.com --project PROJECT. - Concede a la cuenta de servicio del servidor
roles/cloudtranslate.useren ese proyecto:gcloud projects add-iam-policy-binding PROJECT --member serviceAccount:SA_EMAIL --role roles/cloudtranslate.user. - Define
MY_TRANSLATOR_GOOGLE_PROJECTcomo el ID del proyecto.MY_TRANSLATOR_GOOGLE_LOCATIONesglobalpor defecto; puede nombrar otra ubicación de Cloud Translation que sirva el modelo general, comous-central1. - Reinicia el servidor y añade
googleal ajuste de la instanciatranslation_providers.
En Google Cloud con el módulo de OpenTofu mycroblog-gcp, la sección
translation hace los tres primeros pasos, y el apply reinicia el servicio:
translation = {} # or { project_id = "other-project", location = "us-central1" }Activa la API en el proyecto del despliegue, o en project_id, concede allí a la cuenta de servicio del servicio
roles/cloudtranslate.user, y define translator_google_project y translator_google_location. Después añade google a
translation_providers.
El servidor se autentica con Application Default Credentials, como los demás servicios de Google Cloud que usa: en
Cloud Run, la cuenta de servicio del servicio; en otro lugar, el archivo de clave que nombra GOOGLE_APPLICATION_CREDENTIALS. No se usa
ninguna clave de API. El servidor no hace ninguna llamada al arrancar, así que una API o un rol que faltan solo se notan cuando un lector pide una
traducción: el servidor prueba entonces con el siguiente proveedor, y el lector ve que la traducción falló cuando no queda ninguno.
Una cuota o un límite de tasa del proyecto que informa Google también pasa al siguiente proveedor.
Google cobra por los caracteres enviados, tras una franquicia gratuita mensual; consulta los precios de Cloud Translation. Los propios límites mensuales del servidor también cuentan los caracteres, pero no exactamente como los factura Google, así que define también una alerta de presupuesto en Cloud Billing.
Google declara que usa el texto solo para proporcionar la traducción, lo conserva en memoria solo brevemente, no lo usa para entrenar sus modelos y no lo comparte. El servidor llama al endpoint global de Cloud Translation, donde Google no limita el procesamiento a una región.
Los requisitos de atribución de Google piden que una traducción se muestre como
traducida automáticamente y que la insignia «powered by Google Translate» aparezca junto a ella, enlazando a
https://translate.google.com. El cliente web muestra el nombre «Google Translate» con ese enlace junto a cada
traducción de este proveedor. Google ofrece las imágenes de la insignia solo como descarga, así que el servidor no da a los clientes ningún logotipo de
este proveedor; comprueba que lo que ven los lectores cumple los requisitos de Google para tu instancia.
Amazon Translate
Sección titulada «Amazon Translate»Amazon Translate es el proveedor aws. El servidor llama a su operación TranslateText con las credenciales de la
cadena predeterminada del SDK de AWS, como para los demás servicios de AWS: el rol de ejecución de la tarea o instancia, las variables de
entorno AWS_ACCESS_KEY_ID y AWS_SECRET_ACCESS_KEY, o los archivos de credenciales compartidos. Ninguna clave va a la
configuración del servidor.
- Da al rol o usuario con el que se ejecuta el servidor el permiso IAM
translate:TranslateText. Para una publicación cuyo idioma se desconoce, Amazon Translate detecta el idioma con Amazon Comprehend; las políticas gestionadas de AWS para Amazon Translate concedencomprehend:DetectDominantLanguagecon él, así que concédelo también. - Define
translator_aws_region(MY_TRANSLATOR_AWS_REGION) como la región de Amazon Translate, comous-east-1. Detectar el idioma necesita una región donde también funcione Amazon Comprehend. - Reinicia el servidor y luego activa el proveedor con
translation_providers = aws, solo o en tu orden de preferencia entre los demás (ajustes de la instancia).
En AWS con el módulo de OpenTofu mycroblog-aws, la sección
translation hace los dos primeros pasos: translation = {} permite al rol de las tareas ambas acciones y define
translator_aws_region como la región del despliegue, o como region cuando das una. Después activa el proveedor.
Amazon Translate cobra por los caracteres enviados, con un nivel gratuito durante los primeros 12 meses
(precios). El servidor envía solo las palabras de una publicación: las menciones, las etiquetas,
los enlaces y el código permanecen en el servidor, y cada uno va como un marcador corto en marcado HTML. Mantén los límites mensuales
de translation_user_monthly_characters y translation_server_monthly_characters dentro de lo que quieras pagar.
Amazon puede almacenar el texto y usarlo para mejorar sus servicios, posiblemente en otra región, salvo que la
política de exclusión de servicios de IA
de AWS Organizations cubra la cuenta. Sin la exclusión, Amazon no es solo tu proveedor de servicios para ese texto: dilo en tu
política de privacidad (plantilla de política de privacidad), y no permitas
private ni direct para aws en translation_provider_visibilities. Por defecto el proveedor recibe solo las publicaciones public,
local y unlisted.
Para LLM y agentes de programación:llms.txt,llms-full.txt, llms-small.txt