docx
/ doc
- Microsoft Word Documentpptx
- Microsoft PowerPoint Documentxlsx
- Microsoft Excel Documentpdf
- Portable Document Formathtm / html
- HTML Documenttxt
- Plain Text Documentxlf / xliff
- XLIFF Document, version 2.1srt
- SRT (SubRip Subtitle) Documentdoc
file, you will receive a docx
file as the output format./document
endpointmultipart/form-data
.
Please be aware that the uploaded document is automatically removed from the server once the translated document has been downloaded. You have to upload the document again in order to restart the translation.
You may specify the glossary to use for the document translation using the glossary_id
parameter. Important: This requires the source_lang
parameter to be set and the language pair of the glossary has to match the language pair of the request.
For more detail about request body parameters, see the Request Body Descriptions section further down on the page.
https://api.deepl.com
. If you’re an API Free user, remember to update your requests to use https://api-free.deepl.com
instead.model_type
parameter is not supported for API document translation and is only supported for text translation. It’s possible to submit a document translation request that includes the parameter, but the parameter will be ignored and will not have an effect on translation results.
docx
: Microsoft Word Documentpptx
: Microsoft PowerPoint Documentxlsx
: Microsoft Excel Documentpdf
: Portable Document Formathtm / .html
: HTML Documenttxt
: Plain Text Documentxlf / .xliff
: XLIFF Document, version 2.1DE
(German), FR
(French), IT
(Italian), ES
(Spanish), NL
(Dutch), PL
(Polish), PT-BR
and PT-PT
(Portuguese), JA
(Japanese), and RU
(Russian). Learn more about the plain/polite feature for Japanese here. Setting this parameter with a target language that does not support formality will fail, unless one of the prefer_...
options are used. Possible options are:default
(default)more
- for a more formal languageless
- for a more informal languageprefer_more
- for a more formal language if available, otherwise fallback to default formalityprefer_less
- for a more informal language if available, otherwise fallback to default formalitypdf
. If unspecified, by default the translated file will be in the same format as the input file.
Note: Not all combinations of input file and translation file extensions are permitted. See Document format conversions for the permitted combinations.seconds_remaining
parameter is just an estimate and can be unreliable (e.g. sometimes it might return 2^27). We recommend polling the document status, either in regular intervals or with exponential back-off. Translation time depends on the document size and server load, but should be in the order of seconds for small documents and 1-2 minutes for larger documents once translation has started.
https://api.deepl.com
. If you’re an API Free user, remember to update your requests to use https://api-free.deepl.com
instead.done
, the result can be downloaded.
For privacy reasons the translated document is automatically removed from the server once it was downloaded and cannot be downloaded again.
https://api.deepl.com
. If you’re an API Free user, remember to update your requests to use https://api-free.deepl.com
instead.output_format
parameter during document upload, you can select alternative output formats. For example, you can translate a PDF file and receive the translation as an editable Microsoft Word Document (DOCX), allowing you to make additional changes as necessary.
The range of alternative output formats you can select are indicated in the table below:
Input document format | Alternative output document formats |
---|---|
docx - Microsoft Word Document | |
Others | None |