---
title: "Traduzione in blocco con DeepL: limiti, formati supportati e alternative"
description: "Scopri cosa offre DeepL per la traduzione in blocco: limiti dei formati di file, addebito minimo per 50.000 caratteri, limiti di qualità sui file strutturati e alternative."
date: 2026-10-11
language: it
canonical: https://ai-glot.com/it/blog/deepl-bulk-translation
source: AI Glot blog
---
**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](https://developers.deepl.com/docs/best-practices/document-translations) 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.**

*Illustration: DeepL divide la traduzione massiva tra due abbonamenti distinti: l'app web e desktop limita i file caricabili ogni mese, mentre le API fatturano a carattere con una soglia minima di 50.000 caratteri per i documenti Office.*

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](https://developers.deepl.com/docs/resources/usage-limits) e dalle [regole sulle funzionalità alpha e beta](https://developers.deepl.com/docs/resources/alpha-and-beta-features).

| Categoria | Formati in `/v2/document` | Limite di dimensione dell’API a pagamento | Avvertenze importanti della documentazione di DeepL |
| :--- | :--- | :--- | :--- |
| **Documenti per ufficio e pubblicazione in produzione** | `.docx`, `.doc`, `.pptx`, `.pdf`, `.xlsx`, `.idml`, `.mif` | 100 MB (`.docx`, `.pptx`, `.pdf`) o 30 MB (`.xlsx`, `.idml`, `.mif`), fino a 1M caratteri | Per `.docx`, `.doc`, `.pptx`, `.xlsx` e `.pdf` viene addebitato un **minimo di 50,000 caratteri** per caricamento. |
| **Web, dati e sottotitoli in produzione** | `.xlf` / `.xliff` (1.2, 2.0, 2.1), `.xml`, `.html`, `.dita`, `.txt`, `.json`, `.srt` | 10 MB (`.xliff`, `.xml`), 5 MB (`.html`, `.dita`), **1 MB** (`.json`, `.txt`), **150 KB** (`.srt`) | I valori `<target>` esistenti in XLIFF vengono sovrascritti. JSON è limitato a 1 MB e SRT a 150 KB anche con i piani a pagamento. |
| **Solo beta (non per la produzione)** | `.md`, `.yaml` / `.yml`, `.properties`, `.strings`, `.resx`, `.vtt`, `.xlsm`, `.odt`, `.rtf`, `.zip` (solo SCORM) | 1 MB per codice/documenti, 150 KB per `.vtt`, 30 MB per `.xlsm` / `.odt` / `.rtf`, 100 MB per `.zip` SCORM | DeepL specifica che **non sono pensati per la produzione** e che possono subire modifiche incompatibili senza preavviso. |
| **Non supportati in `/v2/document`** | `.csv`, `.tsv`, `.po` / `.pot`, `.arb`, `.xcstrings`, `.stringsdict`, `.ts` (Qt), `.toml`, `.ini`, `.jsonl`, `.ass` / `.ssa`, `.lrc`, cartelle `.zip` standard | Non accettati | I CSV sono accettati solo per caricare glossari a 2 colonne. Gli archivi `.zip` non SCORM generano l’errore `400 Invalid or missing file extension`. |

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](/it/file-formats/csv-translation), `/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`](/it/file-formats/srt-translation) 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`](https://developers.deepl.com/docs/best-practices/document-translations): 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](/it/file-formats/zip-translation) restituisce un errore `400`. Inoltre, i formati fondamentali per le app come [gettext `.po`](/it/file-formats/po-translation), [Flutter `.arb`](/it/file-formats/arb-translation) 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**.

*Illustration: Come la soglia minima di 50.000 caratteri per documento Office di DeepL fa lievitare i costi quando traduci fogli di calcolo piccoli o più lingue di destinazione.*

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.

*Illustration: La traduzione dell'intero documento tratta ogni cella di testo come prosa: slug degli URL e intestazioni vengono tradotti insieme ai titoli dei prodotti, invece di compilare solo la colonna di destinazione vuota.*

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](/it/blog/translate-excel-file-another-language) 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](/it/blog/translate-only-missing-rows-csv-excel) 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`](https://developers.deepl.com/docs/learning-how-tos/examples-and-guides/how-to-use-context-parameter) 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.

*Illustration: Il glossario di un traduttore automatico sostituisce la parola. Un glossario inteso come significato fissa il termine e riscrive la frase intorno ad esso.*

Nel lavoro di localizzazione concreto, [il modo in cui si applica un glossario](/it/blog/how-translation-glossaries-improve-csv-localization) 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:

| Strumento | Ideale per | Formati di file e ambito | Limiti |
| :--- | :--- | :--- | :--- |
| **DeepL** (Translator e API) | Singoli file per l'ufficio (`.docx`, `.pptx`) e chiamate API di testo semplice a bassa latenza per le lingue europee | 14 formati disponibili in produzione e 10 in beta in `/v2/document`. Solo file interi, 1 lingua per caricamento | Niente CSV, PO, ARB, `.xcstrings` o archivi ZIP generici. Minimo fatturabile di 50k caratteri per i file per l'ufficio. Sovrascrive i segmenti di destinazione XLIFF. Elimina il frontmatter Markdown `---`. |
| **AI Glot** | File strutturati in blocco: cataloghi, fogli di calcolo, sottotitoli, documenti Markdown e [file delle lingue delle app](/it/blog/how-to-translate-app-language-files-with-ai) | **Oltre 35 formati** nativamente (CSV, Excel, JSON, XLIFF, PO, ARB, `.xcstrings`, Markdown, SRT, DOCX, PDF, ZIP fino a 200 file) | Non è un traduttore in tempo reale via chat né un marketplace di agenzie di traduzione. |
| **Piattaforme TMS** (Lokalise, Crowdin, Phrase) | Team con responsabili della localizzazione dedicati, connettori Git continui e revisione umana nell'editor | Ampio supporto dei formati di localizzazione tramite strumenti di importazione dei progetti | Richiedono una lunga configurazione del progetto prima di tradurre anche un solo file; i costi per postazione e per chiave ospitata diventano elevati per i batch di file occasionali. |
| **ChatGPT / Claude** (finestra di chat) | Tradurre 20 righe di testo, un'email o trovare idee per slogan pubblicitari localizzati | Testo copiato e incollato o piccoli allegati in chat | I limiti di token di output troncano i file di qualche centinaio di righe; chiavi e virgole CSV si spostano e le regole vengono dimenticate a metà file. |
| **Weglot** | Rendere multilingue un sito web attivo in pochi minuti tramite proxy/JS, senza toccare i file sorgente | Traduce al volo le pagine HTML attive (usa DeepL/Google dietro le quinte) | Vincolo del proxy e [tariffe elevate per fasce di parole](/it/blog/weglot-pricing); non traduce i tuoi CSV offline, i file delle app o i repository di documentazione. |

## 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](/it/file-formats/csv-translation), una [cartella di lavoro Excel](/it/file-formats/excel-translation), un [file di localizzazione JSON](/it/file-formats/json-translation), un [articolo Markdown](/it/file-formats/markdown-translation) (mantenendo intatto il frontmatter YAML `---`), un [file XLIFF esportato](/it/file-formats/xliff-translation) o un [archivio ZIP](/it/file-formats/zip-translation) 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.
```

*Illustration: Descrivi il lavoro in inglese semplice. AI Glot lo trasforma in un piano che puoi leggere e correggere prima dell'esecuzione.*

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](/it/blog/build-translation-glossary-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.

*Illustration: Un glossario definisce i termini che non devono cambiare e applica la stessa scelta a ogni file.*

**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](https://ai-glot.com/docs/mcp/overview), 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](/it/file-formats) oppure **[creare un account AI Glot gratuito](https://app.ai-glot.com/signup)** per ottenere **5.000 parole gratuite** sul primo file e confrontare i risultati affiancati usando i tuoi dati. Consulta i [prezzi](/it/pricing) 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](https://developers.deepl.com/docs/best-practices/document-translations) e dalla [documentazione sui limiti di utilizzo](https://developers.deepl.com/docs/resources/usage-limits), 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.*