DocumentaciónWorkflowsApps y servicios
DeepL: traducir nodo
Traduce texto con DeepL. Funciona con el acceso a DeepL de anymize, así que no necesitas tu propia clave. Se factura por caracteres y el bloque indica los créditos consumidos. Consulta la configuración, las entradas y salidas, las pruebas y la solución de errores.
8 min de lecturaActualizado el
Qué hace este nodo
Traduce texto con DeepL. Funciona con el acceso a DeepL de anymize, así que no necesitas tu propia clave. Se factura por caracteres y el bloque indica los créditos consumidos.
Usa DeepL: traducir como un paso claramente definido en un workflow de anymize.
- Procesa 1 entrada.
- Ofrece 1 salida para los pasos siguientes.
- Se ejecuta como un paso normal del flujo.
Configurar el nodo
- 01Abre un workflow y añade DeepL: traducir desde el catálogo de nodos.
- 02Completa los campos obligatorios y asigna valores de los pasos anteriores.
- 03Ejecuta el nodo con un conjunto pequeño de datos y revisa la salida.
- 04Conecta la salida correcta y activa el workflow después de una prueba completa.
Acciones y modos
DeepL: traducir tiene una función concreta. Sus ajustes aparecen al seleccionar el nodo.
Ajustes
| Campo | Significado | Área |
|---|---|---|
| Texto | Lo que se va a traducir. Arrastra aquí un campo del panel de entrada o escribe un texto fijo. Si lo dejas vacío, el bloque toma el texto del item entrante, también el de un archivo de texto adjunto (txt, csv, md, json, html). | Estándar |
| Idioma de destino | A qué idioma se traduce. Si el idioma viene de los datos, cambia el campo a modo expresión (arriba a la derecha) y escribe por ejemplo {{ $json.target_lang }}. | Estándar |
| Anonimizar antes de enviar | Activado (por defecto): nombres, direcciones, números y otros datos personales se sustituyen por marcadores antes de que el texto llegue a DeepL, y se reponen con los valores reales en la traducción. DeepL nunca ve los datos en claro. No cuesta nada más. Desactívalo solo para textos en los que estés seguro de que no hay nada personal. | Estándar |
| Idioma de origen | Normalmente déjalo en «Detectar automáticamente»: DeepL encuentra el idioma de origen por su cuenta. Fíjalo solo si el texto es corto o mezcla varios idiomas. | Estándar |
| Tono | Formal o cercano. Solo tiene efecto en idiomas que distinguen entre ambos (alemán, francés, español, italiano, neerlandés, polaco, portugués, japonés, ruso) - en el resto DeepL lo ignora. | Estándar |
| Proteger los marcadores de anonimización | Activado (por defecto): los marcadores del tipo [[categoría-hash]] se envuelven para que DeepL los ignore y los devuelva sin cambios. Desactívalo solo si sabes con seguridad que el texto no tiene ninguno. | Estándar |
| Adjuntar la traducción como archivo de texto | Añade además la traducción como .txt al item, para que los bloques siguientes puedan pasarla como archivo - por ejemplo adjunta a un correo o subida a un almacenamiento. | Estándar |
| Ejecutar una vez por elemento | Desactivado (por defecto): el nodo se ejecuta una vez para toda la entrada. Activado: si recibe varios elementos (por ejemplo de «Dividir lista»), se ejecuta una vez POR elemento, y {{ $json }} es justo ese elemento. Así procesas una lista de archivos entrada por entrada. | Estándar |
| Si un elemento falla | «Omitir» escribe un campo `error` para el elemento fallido y sigue con el resto, en lugar de perder toda la ejecución por un único archivo ilegible. | Estándar |
| Pausa entre elementos (milisegundos) | Espera antes de cada ejecución excepto la primera. 1000 = 1 segundo por elemento. Útil si el otro extremo te limita. Máximo 300000 (5 minutos). | Estándar |
Entradas y salidas
| Entrada | Significado | Tipo |
|---|---|---|
| text | Texto que se va a traducir. Sustituye al campo de configuración. | text |
| target_lang | Idioma de destino como código DeepL, p. ej. EN-US. Sustituye al campo de configuración. | text |
| Salida | Significado | Tipo |
|---|---|---|
| text | La traducción. | text |
| detected_source_lang | Idioma que DeepL ha detectado en el texto original. | text |
| target_lang | Idioma al que se ha traducido. | text |
| billed_characters | Caracteres facturados por DeepL. Base de los créditos. | number |
| credits | Créditos que ha costado este paso. | number |
| input_text | El texto original, sin cambios. | text |
| anonymized | true si el texto se anonimizó antes de llegar a DeepL. | boolean |
| anonymized_input | Exactamente el texto que recibió DeepL. Con la anonimización activa, el texto con marcadores. | text |
| placeholders | Cuántos marcadores ha puesto el bloque. | number |
| restored_placeholders | Cuántos de ellos se han vuelto a sustituir por los valores reales en la traducción. | number |
Este nodo puede procesar listas elemento por elemento. La gestión de errores y la pausa están en los ajustes avanzados.
Ejemplo y prueba
Traducir una consulta de cliente: empieza con un conjunto pequeño y reconocible. Revisa la salida y usa solo los campos que estén presentes.
Ejemplo de prueba
{
"text": "Guten Tag, wir bitten um ein Angebot für 20 Lizenzen zum 1. Oktober.",
"target_lang": "EN-US"
}Acceso y seguridad
Antes de activarlo, revisa los datos que entran en este paso y el contenido de la salida.
Guarda claves y credenciales en el gestor protegido. No las pegues en campos normales, datos de prueba ni descripciones.
Resolver errores
- Sin salida: revisa la última ejecución y los campos entregados por el nodo anterior.
- Variable vacía: abre la salida anterior y usa un campo presente en los datos reales.
- La lista se procesa una sola vez: activa la ejecución por elemento.