Traduzione in blocco con DeepL: limiti, formati supportati e alternative

DeepL è il primo strumento che la maggior parte dei team prova quando deve tradurre una cartella di file e, per un singolo documento Word o qualche paragrafo di prosa europea, si dimostra all’altezza della sua reputazione. Le difficoltà iniziano quando si passa dalla traduzione di un documento a un flusso di lavoro di localizzazione in blocco: cataloghi di prodotti in CSV o Excel, file di lingua di un’app in dieci lingue, documentazione Markdown con frontmatter o fogli di calcolo tradotti solo in parte, in cui vanno aggiornate soltanto le nuove righe.

Ho creato AI Glot dopo essermi scontrato personalmente con questi stessi ostacoli. All’inizio pensavo che bastasse aggiungere un wrapper all’API di traduzione automatica. Quando abbiamo esaminato da vicino la documentazione ufficiale per sviluppatori di DeepL e parlato con i team che stavano trasferendo i propri flussi di lavoro, sono emersi due problemi distinti: limiti tecnici e di fatturazione rigidi per i file tradotti in blocco e un meccanismo di traduzione stringa per stringa che perde il contesto nei dati strutturati.

DeepL Translator e DeepL API: due prodotti distinti

Chi cerca «traduzione in blocco con DeepL» di solito ha in mente uno di questi due flussi di lavoro: trascinare più file nell’app DeepL oppure collegare uno script alle API di DeepL. Sono due modalità legate ad abbonamenti distinti, con quote separate.

Per il web e desktop, i piani a pagamento di DeepL (i cui nomi sono stati recentemente modificati da Starter, Advanced e Ultimate in Individual, Team e Business) impongono rigidi limiti mensili di caricamento dei file per utente:

• Individual: 3 traduzioni di file al mese (fino a 300,000 caratteri al mese).
• Team: 20 traduzioni di file al mese (fino a 1,000,000 caratteri al mese).
• Business: 100 traduzioni di file al mese.

Poiché ogni lingua di destinazione viene conteggiata come una traduzione di file separata, localizzare 5 documenti in 6 lingue richiede 30 traduzioni di file, superando subito la quota mensile di una licenza Team.

Per eliminare il limite mensile di file, devi acquistare un abbonamento separato DeepL API Pro (tariffa base di $5.49 al mese più $25.00 per milione di caratteri, oppure €4.99 più €20.00 per milione di caratteri in Europa). L’API offre due endpoint:

1. POST /v2/translate: accetta un array di stringhe di testo semplice (fino a 50 stringhe per chiamata, con un limite massimo complessivo di 128 KiB per il corpo della richiesta). Devi analizzare i tuoi file, rimuoverne la struttura, suddividere le stringhe in batch e ricostruire il file in seguito.
2. POST /v2/document: accetta un file intero per una lingua di destinazione, lo mette in coda in modo asincrono e restituisce il file tradotto, che puoi controllare e scaricare.

Quali formati DeepL supporta davvero in blocco (e quali mancano o sono in beta)

Se usi /v2/document per evitare di scrivere un parser personalizzato per ogni formato, il tuo flusso di lavoro è vincolato dai limiti di dimensione di DeepL per formato e dalle regole sulle funzionalità alpha e beta.

Quattro dettagli della tabella colgono di sorpresa i team di ingegneria e localizzazione:

• Nessuna traduzione nativa di documenti CSV o TSV. Se il tuo negozio e-commerce, PIM o CMS esporta un file CSV, /v2/document lo rifiuta. Puoi convertire manualmente ogni CSV in .xlsx (con l’addebito minimo di 50,000 caratteri per file e la traduzione indiscriminata di tutte le colonne) oppure creare un parser CSV personalizzato basato su /v2/translate.
• Limiti di 1 MB e 150 KB per file di sviluppo e sottotitoli. Anche con un piano API Pro a pagamento, i file .json, .yaml, .md, .properties, .strings e .resx sono limitati a 1 MB, mentre i file di sottotitoli .srt e .vtt sono limitati a 150 KB. Un singolo file di sottotitoli di un lungometraggio o un file JSON locale monolitico supera spesso questi limiti.
• Markdown e file di localizzazione sono ancora in beta e presentano un problema noto con il frontmatter. La documentazione di DeepL avverte esplicitamente di non usare le funzionalità beta nei flussi di lavoro di produzione. Più nello specifico, la guida di DeepL alla traduzione di documenti segnala un bug noto nei file .md: nel file tradotto vengono eliminati i delimitatori --- che racchiudono i blocchi YAML di frontmatter, facendo confluire i metadati della pagina nel paragrafo iniziale. Se gestisci un sito Astro, Next.js, Hugo o Docusaurus, la compilazione non va a buon fine per ogni pagina tradotta.
• Le cartelle ZIP standard vengono rifiutate. L’estensione .zip in /v2/document accetta solo pacchetti e-learning SCORM che contengono un imsmanifest.xml nella cartella principale. Il caricamento di un normale archivio ZIP di file di localizzazione restituisce un errore 400. Inoltre, i formati fondamentali per le app come gettext .po, Flutter .arb e i cataloghi di stringhe Xcode .xcstrings](/it/file-formats/xcstrings-translation) non sono supportati.

Il minimo di fatturazione di 50,000 caratteri per Excel, Word, PowerPoint e PDF

Con una tariffa di $25 per milione di caratteri, il prezzo API pubblicizzato da DeepL sembra corrispondere a $0.025 per mille caratteri. Il calcolo è corretto per /v2/translate, ma non per /v2/document quando elabori gruppi di file Office.

La documentazione di DeepL indica due regole di fatturazione per i file .docx, .doc, .pptx, .xlsx e .pdf caricati:

1. Ogni documento inviato viene fatturato per un minimo di 50,000 caratteri, indipendentemente dal numero effettivo di caratteri contenuti nel file.
2. Tutto il contenuto del file caricato rientra nel conteggio dei caratteri fatturati, anche quello che non è stato tradotto.

Poiché /v2/document traduce un file in una sola lingua di destinazione per richiesta, ogni lingua di destinazione moltiplica questo minimo di 50,000 caratteri.

Considera questo esempio: hai 20 piccoli fogli Excel di prodotti con una media di 2,500 caratteri ciascuno (circa 400 parole per file, per un totale di 50,000 caratteri nei 20 file) e devi tradurli in 5 lingue di destinazione.

• In realtà, traduci 250,000 caratteri complessivi nelle cinque lingue. Con una tariffa di $25 per milione di caratteri, ti aspetteresti di pagare $6.25.
• Poiché /v2/document richiede 100 caricamenti separati di file .xlsx (20 file × 5 lingue) e applica un minimo di 50,000 caratteri a ciascuno, DeepL fattura 5,000,000 caratteri, per un totale di $125.00 (20 volte la tariffa calcolata sui caratteri effettivi).
• Anche se il tuo file .xlsx supera i 50,000 caratteri, DeepL conteggia tutti i caratteri della cartella di lavoro, comprese le colonne SKU, gli URL, le note interne e le righe già tradotte il mese scorso.

Perché la traduzione dell’intero file compromette i flussi di lavoro con fogli di calcolo e localizzazione

Il costo è solo metà del problema quando carichi file interi. Il problema più profondo è che /v2/document non prevede ambiti configurabili. Quando gli invii un file strutturato, non puoi indicargli quali parti siano contenuti da tradurre e quali siano dati strutturali.

Nei file usati davvero in produzione emergono subito quattro lacune nei flussi di lavoro:

1. In Excel non puoi selezionare le colonne. Se carichi una cartella di lavoro Excel su DeepL, vengono tradotte tutte le celle di testo di ogni foglio. Handle dei prodotti, slug delle categorie, nomi dei fornitori e flag di stato vengono tradotti insieme alle descrizioni dei prodotti. Nella sua documentazione, DeepL segnala che le formule VLOOKUP, MATCH e INDEX basate su stringhe letterali si interrompono se viene tradotta la tabella a cui fanno riferimento.
2. Non puoi tradurre solo le righe mancanti. La maggior parte dei cataloghi e dei file di localizzazione è tradotta solo in parte: 3,800 righe sono state completate a marzo e questa settimana sono arrivati 200 nuovi prodotti. DeepL non può tradurre solo le righe mancanti in un foglio di calcolo e, per i file .xliff, la sua documentazione avverte che i valori <target> esistenti vengono sovrascritti. Prima di caricare il file, devi quindi rimuovere dall’XML i nodi <trans-unit> già tradotti e reinserirli dopo.
3. Un solo idioma per caricamento. Se un foglio di calcolo contiene en, fr, de ed es in colonne affiancate nello stesso file, DeepL non può compilare direttamente le colonne di destinazione. Restituisce un file separato per ogni lingua, sovrascrivendo le celle di origine.
4. Nessun piano da esaminare prima di spendere. Una chiamata POST /v2/document avvia subito la traduzione e la fatturazione. Non c’è una fase di prova che mostri quali campi sono stati individuati, quante parole rientrano nell’ambito e quanto costerà il lavoro prima che tu lo approvi.

Dove la qualità di DeepL mostra i suoi limiti sui contenuti reali

Chi ha usato DeepL non direbbe che traduce male una singola frase. Su un paragrafo di prosa generica in francese, tedesco o spagnolo, il suo motore neurale è rapido e scorrevole.

Eppure, spesso i clienti si rivolgono a noi dopo aver provato DeepL e AI Glot sui loro file reali, perché DeepL non ha raggiunto il livello di qualità necessario per pubblicare i contenuti sul loro sito, mentre AI Glot sì. Si tratta di esperienze dei clienti, non di un benchmark formale: non abbiamo eseguito test sintetici comparativi con DeepL e dovresti diffidare di qualsiasi fornitore che inventi un punteggio percentuale. La ragione di questa differenza dipende dal meccanismo con cui viene tradotto un batch.

1. Stringhe isolate invece di consapevolezza del documento e dei campi

Per creare uno script basato sull’endpoint /v2/translate di DeepL ed evitare di compromettere la struttura di CSV o JSON, invii una matrice con un massimo di 50 stringhe per richiesta. La specifica OpenAPI di DeepL indica chiaramente questo limite: “Ogni testo nella matrice viene tradotto in modo indipendente; i testi non condividono il contesto.”

Se un traduttore vede "Light" in una matrice di stringhe isolate, non può sapere se il file riguarda un catalogo di lampade, una tabella di integratori alimentari o un interruttore di un tema nel menu delle impostazioni di un’app SaaS. Anche se passi il parametro opzionale context di DeepL a /v2/translate (non disponibile su /v2/document), la guida di DeepL al parametro context avverte esplicitamente: “Molti utenti cercano di usare context come i prompt di sistema di ChatGPT. Non funziona in modo affidabile… Mantieni il contesto come testo semplice tratto dallo stesso documento, non come istruzioni.”

2. Sostituzione dei termini invece di un glossario che ne conserva il significato

DeepL supporta glossari (v3/glossaries) in 26 lingue di partenza, con un limite di 1,024 byte UTF-8 per voce. Pur adattando le flessioni più semplici di nomi e verbi, un glossario per la traduzione automatica è, per sua natura, una tabella di corrispondenze 1 a 1: ogni volta che compare il termine di partenza A, viene sostituito con il termine di arrivo B.

Nel lavoro di localizzazione concreto, il modo in cui si applica un glossario determina se una frase suona naturale:

• Una tabella di corrispondenze uno a uno non può capire perché un termine è bloccato né applicare una regola condizionale come “Mantieni ‘Pro’ e ‘Workspace’ in inglese quando si riferiscono ai nostri piani tariffari o alla navigazione dell’interfaccia, ma traducili normalmente nelle frasi generiche.”
• Di recente DeepL ha aggiunto custom_instructions alla propria API v3/style_rules (disponibile nei piani Pro e Business per una parte delle lingue di destinazione), ma ogni regola di stile è limitata a un massimo di 10 istruzioni personalizzate di 300 caratteri ciascuna, applicate frase per frase. Come spiega la stessa guida di DeepL alle regole di stile, questo le rende poco affidabili per le regole che dipendono dalla struttura più ampia del documento.

DeepL a confronto con le alternative per le traduzioni in blocco

Nessuno strumento è il migliore per ogni tipo di traduzione. Ecco come si confronta DeepL con le principali alternative quando hai grandi volumi da tradurre:

Come funziona un flusso di lavoro mirato in blocco con AI Glot

Quando trasferisci un batch da tradurre in blocco da DeepL ad AI Glot, cambiano tre aspetti del flusso di lavoro: non devi prima convertire il file, definisci l’ambito con parole semplici e leggi il piano prima di spendere un centesimo.

1. Carica il file così com’è. Carica un file CSV esportato, una cartella di lavoro Excel, un file di localizzazione JSON, un articolo Markdown (mantenendo intatto il frontmatter YAML ---), un file XLIFF esportato o un archivio ZIP con un massimo di 200 file.

2. Descrivi in una frase cosa deve essere fatto. Invece di scrivere uno script Python per filtrare le righe e rimuovere le colonne prima di chiamare un’API, definisci l’ambito con parole semplici:

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 trasforma quella frase in un programma deterministico che elabora il file e seleziona esattamente i campi e le righe inclusi nell’ambito. La riga 18.000 viene sottoposta allo stesso identico controllo della riga 1.

3. Esamina il piano gratuito prima di approvarlo. Prima che venga utilizzato anche un solo credito, il piano mostra i campi corrispondenti, il conteggio esatto degli elementi e delle parole, un’anteprima della struttura del risultato e il costo in crediti. Se l’istruzione ha selezionato una colonna che volevi escludere, modifichi la frase e crei un nuovo piano gratuitamente.

4. Applica il glossario dell’area di lavoro e le istruzioni per il batch. Il tuo glossario del brand e le regole sul tono accompagnano ogni batch nel modello di traduzione. La terminologia viene così integrata nella grammatica della frase, invece di essere sostituita alla cieca in un secondo momento.

5. Avvialo dall’app, dalla CLI o dal tuo agente AI. Puoi procedere nel browser, automatizzare il flusso nella CI con la CLI aiglot oppure collegare AI Glot come server MCP, così Claude Code o Cursor possono tradurre direttamente i file delle lingue del tuo repository.

Quando continuare a usare DeepL e quando passare a un’alternativa

Continua a usare DeepL quando devi tradurre pochi documenti Word o presentazioni isolati, in cui va tradotta ogni riga di testo del file, oppure quando ti serve un’API di traduzione automatica neurale con risposta in meno di un secondo per il testo generato dagli utenti in tempo reale in un widget di chat.

Passa a un motore di traduzione che riconosce la struttura dei file non appena si verifica una di queste condizioni:

• I tuoi dati sono in CSV, TSV, PO, ARB, .xcstrings, TOML, Markdown con frontmatter o in una cartella ZIP di file di localizzazione.
• Devi tradurre molti file .xlsx o .docx di piccole dimensioni (o in diverse lingue di destinazione) e non vuoi pagare il minimo di 50.000 caratteri richiesto da DeepL per ogni file e ogni lingua.
• Il tuo file contiene colonne, chiavi o righe già tradotte che non devono essere modificate e non vuoi più scrivere script di pre-elaborazione e post-elaborazione per usare un’API.
• Ti serve applicare glossario, segnaposto e brief del brand tenendo conto del contesto completo, così il risultato soddisfa i tuoi standard di pubblicazione già al primo tentativo.

Puoi provare qualsiasi formato senza creare un account con i nostri strumenti gratuiti per la traduzione di file oppure creare un account AI Glot gratuito per ottenere 5.000 parole gratuite sul primo file e confrontare i risultati affiancati usando i tuoi dati. Consulta i prezzi per i pacchetti di crediti per grandi volumi.

Tutte le specifiche tecniche di DeepL, i limiti alle dimensioni dei file, le indicazioni sullo stato beta e le regole di fatturazione citati in questo articolo provengono dalla documentazione ufficiale per sviluppatori di DeepL e dalla documentazione sui limiti di utilizzo, aggiornate a ottobre 2026. Il calcolo per il foglio di calcolo con 20 file e le righe della tabella dei prodotti nei diagrammi sono esempi illustrativi che mostrano come si applicano le regole pubblicate.