Traducción masiva con DeepL: límites, compatibilidad con archivos y alternativas

DeepL es la primera herramienta que prueban la mayoría de los equipos cuando tienen una carpeta de archivos que traducir, y para un documento de Word o unos cuantos párrafos de prosa europea, está a la altura de su reputación. Las dificultades empiezan cuando pasas de traducir un documento a gestionar un flujo de localización masiva: catálogos de productos en CSV o Excel, archivos de idioma de una aplicación en diez idiomas, documentación Markdown con metadatos frontmatter o hojas de cálculo traducidas parcialmente en las que solo hay que trabajar las filas nuevas.

Creé AI Glot después de toparme con estos mismos obstáculos. Al principio, pensaba que la traducción automática solo necesitaba una capa sobre su API. Pero, cuando analizamos a fondo la documentación oficial para desarrolladores de DeepL y hablamos con equipos que estaban migrando sus lotes, detectamos dos problemas distintos: límites técnicos y de facturación estrictos para los archivos por lotes, y un mecanismo de traducción cadena por cadena que pierde el contexto de los datos estructurados.

DeepL Translator y DeepL API: dos productos distintos

Quien busca «traducción masiva con DeepL» suele tener en mente uno de estos dos flujos de trabajo: arrastrar un lote de archivos a la aplicación de DeepL o conectar un script a la API de DeepL. Son opciones con suscripciones independientes y no comparten cuotas.

En la web y en la aplicación de escritorio, los planes de pago de DeepL (cuyos nombres cambiaron hace poco de Starter, Advanced y Ultimate a Individual, Team y Business) imponen límites mensuales estrictos a las cargas de archivos por usuario:

• Individual: 3 traducciones de archivos al mes (hasta 300,000 caracteres al mes).
• Team: 20 traducciones de archivos al mes (hasta 1,000,000 de caracteres al mes).
• Business: 100 traducciones de archivos al mes.

Como cada idioma de destino cuenta como una traducción de archivo independiente, localizar 5 documentos a 6 idiomas consume 30 traducciones de archivos, lo que supera de inmediato la asignación mensual de una licencia Team.

Para eliminar el contador mensual de archivos, tienes que contratar una suscripción independiente a DeepL API Pro (cuota base de $5.49 al mes más $25.00 por cada millón de caracteres, o €4.99 más €20.00 por cada millón de caracteres en Europa). La API ofrece dos endpoints:

1. POST /v2/translate: acepta una matriz de cadenas de texto sin procesar (hasta 50 cadenas por llamada, con un límite estricto de 128 KiB para el cuerpo total de la solicitud). Tienes que analizar tus propios archivos, eliminar su estructura, agrupar las cadenas y reconstruir el archivo después.
2. POST /v2/document: acepta un archivo completo para un idioma de destino, lo procesa de forma asíncrona y devuelve un archivo traducido que puedes consultar y descargar.

Qué archivos admite DeepL realmente en traducciones masivas (y cuáles faltan o están en beta)

Si usas /v2/document para no tener que crear un analizador personalizado para cada formato, tu flujo de trabajo queda sujeto a los límites de tamaño de DeepL por formato y a sus condiciones para las funciones alfa y beta.

Hay cuatro detalles de esta tabla que suelen pillar desprevenidos a los equipos de ingeniería y localización:

• No permite traducir documentos CSV o TSV de forma nativa. Si tu tienda de comercio electrónico, PIM o CMS exporta un archivo CSV, /v2/document lo rechaza. Puedes convertir cada CSV a .xlsx manualmente (lo que activa el cargo mínimo de 50,000 caracteres por archivo y traduce todas las columnas sin distinción) o crear tu propio analizador de CSV para /v2/translate.
• Límites de 1 MB y 150 KB para archivos de desarrollo y subtítulos. Incluso con un plan API Pro de pago, los archivos .json, .yaml, .md, .properties, .strings y .resx tienen un límite de 1 MB, y los archivos de subtítulos .srt y .vtt, de 150 KB. Un solo archivo de subtítulos de un largometraje o un archivo JSON monolítico de localización suele superar esos límites.
• Markdown y los archivos de localización siguen en beta y tienen un error conocido con el frontmatter. La documentación de DeepL advierte expresamente que no se deben usar las funciones beta en flujos de trabajo de producción. Además, la guía de DeepL sobre documentos señala un error conocido en los archivos .md: los delimitadores --- que abren y cierran los bloques de frontmatter YAML desaparecen del archivo traducido, y los metadatos de la página se fusionan con el párrafo inicial. Si usas un sitio de Astro, Next.js, Hugo o Docusaurus, la compilación fallará en cada página traducida.
• Se rechazan las carpetas ZIP estándar. La extensión .zip en /v2/document solo admite paquetes de aprendizaje electrónico SCORM que incluyan un imsmanifest.xml en la raíz. Si cargas un archivo ZIP estándar con archivos de localización, recibirás un error 400. Tampoco se admiten formatos habituales de aplicaciones como gettext .po, Flutter .arb y los catálogos de cadenas Xcode .xcstrings de Xcode.

El mínimo de facturación de 50.000 caracteres para Excel, Word, PowerPoint y PDF

A 25 $ por millón de caracteres, la tarifa API anunciada por DeepL parece equivaler a 0,025 $ por cada mil caracteres. Ese cálculo se cumple en /v2/translate, pero deja de ser válido en /v2/document cuando procesas lotes de archivos de Office.

La documentación de DeepL establece dos reglas de facturación para los archivos .docx, .doc, .pptx, .xlsx y .pdf que subas:

1. Cada documento enviado se factura con un mínimo de 50.000 caracteres, por pocos caracteres que contenga el archivo.
2. Todo el contenido del archivo subido cuenta para el total de caracteres facturados, incluso el contenido que no se haya traducido.

Como /v2/document traduce un archivo a un idioma de destino por solicitud, cada idioma de destino aplica de nuevo el mínimo de 50.000 caracteres.

Veamos un ejemplo: tienes 20 pequeñas hojas de productos de Excel con una media de 2.500 caracteres cada una (unas 400 palabras por archivo, o 50.000 caracteres en total entre los 20 archivos) y necesitas traducirlas a 5 idiomas de destino.

• En realidad, estás traduciendo 250.000 caracteres entre los cinco idiomas. A 25 $ por millón de caracteres, esperarías pagar 6,25 $.
• Como /v2/document requiere 100 cargas independientes de archivos .xlsx (20 archivos × 5 idiomas) y aplica un mínimo de 50.000 caracteres a cada uno, DeepL factura 5.000.000 de caracteres, lo que equivale a 125,00 $ (20 veces la tarifa por caracteres real).
• Aunque tu archivo .xlsx tenga más de 50.000 caracteres, DeepL cuenta todos los caracteres del libro para calcular la factura, incluidas las columnas de SKU, las URL, las notas internas y las filas que ya se tradujeron el mes pasado.

Por qué traducir archivos completos perjudica los flujos de trabajo con hojas de cálculo y de localización

El coste es solo la mitad del problema de subir archivos completos. El problema de fondo es que /v2/document no permite definir un ámbito programable. Cuando le pasas un archivo estructurado, no puedes indicarle qué partes son contenido traducible y cuáles forman parte de la estructura de datos.

En archivos reales de producción, enseguida quedan a la vista cuatro carencias del flujo de trabajo:

1. Excel no permite seleccionar columnas. Si subes un libro de Excel a DeepL, se traducen todas las celdas de texto de todas las hojas. Los identificadores de productos, los slugs de categorías, los nombres de proveedores y los indicadores de estado se traducen junto con las descripciones de los productos. La propia documentación de DeepL señala que las fórmulas VLOOKUP, MATCH e INDEX que buscan valores de texto dejan de funcionar si se traduce la tabla a la que hacen referencia.
2. No permite traducir de forma incremental las filas que faltan. La mayoría de los catálogos y archivos de localización están traducidos solo en parte: se completaron 3,800 filas en marzo y esta semana han llegado 200 productos nuevos. DeepL no puede traducir solo las filas que faltan en una hoja de cálculo y, en archivos .xliff, su documentación advierte que se sobrescriben los valores <target> existentes. Por eso, antes de subir el archivo, hay que eliminar del XML los nodos <trans-unit> ya traducidos y volver a incorporarlos después.
3. Una sola lengua por archivo subido. Si tu hoja de cálculo contiene en, fr, de y es en columnas contiguas dentro del mismo archivo, DeepL no puede rellenar las columnas de destino en su sitio. Devuelve un archivo independiente por lengua y sobrescribe las celdas de origen.
4. No puedes revisar el plan antes de incurrir en gastos. Una llamada POST /v2/document inicia la traducción y la facturación de inmediato. No hay una fase de prueba que te muestre qué campos se han identificado, cuántas palabras se incluyen y cuánto costará el trabajo antes de que lo apruebes.

Hasta dónde llega la calidad de DeepL con contenido real

Nadie que haya usado DeepL diría que traduce mal una frase aislada. Para un párrafo de prosa general en francés, alemán o español, su motor neuronal es rápido y fluido.

Aun así, los clientes suelen acudir a nosotros después de probar DeepL y AI Glot con sus propios archivos porque DeepL no alcanzó el nivel de calidad que necesitaban para publicar en su sitio web, mientras que AI Glot sí lo hizo. Esto refleja la experiencia de los clientes, no una prueba comparativa formal (no hemos realizado pruebas sintéticas frente a DeepL, y conviene desconfiar de cualquier proveedor que se invente una puntuación porcentual). La causa está en el mecanismo que se utiliza para traducir por lotes.

1. Cadenas aisladas frente a conocimiento del documento y de los campos

Si creas un script en torno al endpoint /v2/translate de DeepL para evitar que se rompa la estructura de tu CSV o JSON, envías una matriz de hasta 50 cadenas por solicitud. La especificación OpenAPI de DeepL lo indica claramente: «Cada texto de la matriz se traduce de forma independiente; los textos no comparten contexto entre sí».

Si un traductor ve "Light" en una matriz de cadenas aisladas, no tiene forma de saber si el archivo es un catálogo de iluminación, una tabla de suplementos alimenticios o un selector de tema en el menú de configuración de una aplicación SaaS. Aunque pases el parámetro opcional context de DeepL a /v2/translate (que no está disponible en /v2/document), la guía de DeepL sobre el parámetro context advierte expresamente: «Muchos usuarios intentan usar context como si fueran instrucciones del sistema de ChatGPT. Esto no funciona de forma fiable… Usa como contexto solo texto del mismo documento, no instrucciones».

2. Sustitución de términos frente a un glosario que transmite significado

DeepL admite glosarios (v3/glossaries) en 26 idiomas de origen, con un límite de 1,024 bytes UTF-8 por entrada. Aunque adapta las flexiones básicas de sustantivos y verbos, un glosario de traducción automática es, en esencia, una tabla de equivalencias uno a uno: cada vez que aparece el término de origen A, se sustituye por el término de destino B.

En el trabajo real de localización, la forma de aplicar un glosario determina si una frase suena natural:

• Una tabla de equivalencias uno a uno no puede entender por qué se bloquea un término ni aplicar una regla condicional como «Mantén “Pro” y “Workspace” en inglés cuando se refieran a nuestros planes de precios o a la navegación de la interfaz, pero tradúcelos con normalidad en frases generales».
• DeepL ha añadido hace poco custom_instructions a su API v3/style_rules (disponible en los planes Pro y Business para algunos idiomas de destino), pero cada regla de estilo está limitada a un máximo de 10 instrucciones personalizadas de 300 caracteres cada una, aplicadas frase por frase. Como señala la propia guía de reglas de estilo de DeepL, esto hace que no sean fiables para reglas que dependen de la estructura general del documento.

DeepL frente a otras opciones para traducciones de grandes volúmenes

No hay una herramienta que sea la mejor para todos los trabajos de traducción. Así se compara DeepL con las principales alternativas cuando tienes que procesar un volumen considerable:

Cómo funciona un flujo de trabajo por lotes con alcance definido en AI Glot

Al pasar un lote de DeepL a AI Glot, cambian tres aspectos del flujo de trabajo: no tienes que convertir el archivo antes, defines el alcance del trabajo en lenguaje corriente y revisas el plan antes de gastar un céntimo.

1. Sube el archivo tal cual. Añade una exportación CSV, un libro de Excel, un archivo de idioma JSON, un artículo Markdown (con sus metadatos iniciales YAML --- intactos), una exportación XLIFF o un archivo ZIP con hasta 200 archivos.

2. Explica en una frase qué hay que hacer. En lugar de escribir un script de Python para filtrar filas y eliminar columnas antes de llamar a una API, defines el alcance en lenguaje corriente:

Translate title_en and body_html into French and German.
Only translate rows where the target cell is empty.
Leave sku, handle, and vendor untouched.

AI Glot convierte esa frase en un programa determinista que procesa el archivo y selecciona exactamente los campos y las filas incluidos en el alcance. La fila 18,000 se somete a la misma comprobación que la fila 1.

3. Revisa el plan gratuito antes de aprobarlo. Antes de gastar créditos, el plan te muestra los campos coincidentes, el número exacto de elementos y palabras, una vista previa de la estructura de salida y el coste en créditos. Si la instrucción incluye una columna que querías excluir, modifica la frase y vuelve a generar el plan gratis.

4. Aplica el glosario del espacio de trabajo y las instrucciones del lote. Tu glosario de marca y las pautas de tono acompañan a cada lote cuando se envía al modelo de traducción. Así, la terminología se integra en la gramática de la frase, en lugar de sustituirse a ciegas después.

5. Ejecútalo desde la aplicación, la CLI o tu agente de IA. Puedes hacerlo desde el navegador, automatizar el proceso en CI con la CLI aiglot o conectar AI Glot como servidor MCP para que Claude Code o Cursor traduzcan directamente los archivos de idioma de tu repositorio.

Cuándo seguir con DeepL y cuándo cambiar

Sigue con DeepL si traduces unos pocos documentos de Word o presentaciones independientes en los que haya que traducir todo el texto, o si necesitas una API de traducción automática neuronal en menos de un segundo para el texto que los usuarios generan en directo en un widget de chat.

Cámbiate a un motor de traducción que tenga en cuenta los archivos en cuanto se cumpla alguna de estas condiciones:

• Tus datos están en CSV, TSV, PO, ARB, .xcstrings, TOML, Markdown con metadatos iniciales o una carpeta ZIP con archivos de localización.
• Traducirás muchos archivos .xlsx o .docx pequeños (o a varios idiomas de destino) y no quieres pagar el cargo mínimo de DeepL de 50,000 caracteres por archivo y por idioma.
• Tu archivo contiene columnas, claves o filas ya traducidas que no se deben modificar, y estás cansado de escribir scripts de preprocesamiento y posprocesamiento para una API.
• Necesitas que se apliquen tu glosario, marcadores de posición y guía de marca con todo el contexto, para que el resultado cumpla tus criterios de publicación a la primera.

Puedes probar cualquier formato sin crear una cuenta con nuestras herramientas gratuitas para traducir archivos o crear una cuenta gratuita de AI Glot para traducir gratis tus primeros 5,000 palabras en el primer archivo y comparar los resultados en paralelo con tus propios datos. Consulta los precios para ver los paquetes de créditos por volumen.

Todas las especificaciones técnicas de DeepL, los límites de tamaño de archivo, las etiquetas de estado beta y las normas de facturación mencionadas en este artículo proceden de la documentación oficial para desarrolladores de DeepL y de la referencia de límites de uso, consultadas en octubre de 2026. El cálculo para 20 hojas de cálculo y las filas de la tabla de producto de los diagramas son ejemplos ilustrativos de cómo se aplican las normas publicadas.