diff --git a/api-reference/openapi.json b/api-reference/openapi.json index 2d3a9182..bea38c28 100644 --- a/api-reference/openapi.json +++ b/api-reference/openapi.json @@ -35,7 +35,7 @@ }, { "name": "TranslateDocuments", - "description": "The document translation API allows you to translate whole documents and supports the following file types and extensions:\n * `docx` - Microsoft Word Document\n * `pptx` - Microsoft PowerPoint Document\n * `xlsx` - Microsoft Excel Document\n * `xlsm` - Microsoft Excel Macro-Enabled Workbook (currently in beta)\n * `pdf` - Portable Document Format\n * `htm / html` - HTML Document\n * `txt` - Plain Text Document\n * `xlf / xliff` - XLIFF Document (versions 1.2, 2.0, and 2.1)\n * `srt` - SRT Document\n * `vtt` - WebVTT Subtitle Document (currently in beta)\n * `idml` - Adobe InDesign Markup Language\n * `xml` - XML Document\n * `json` - JSON Document\n * `yaml / yml` - YAML Document (currently in beta)\n * `properties` - Java Properties Document (currently in beta)\n * `strings` - iOS/macOS Strings Document (currently in beta)\n * `md / markdown` - Markdown Document (currently in beta)\n * `dita` - DITA topic (Darwin Information Typing Architecture)\n * `mif` - Adobe FrameMaker Interchange Format\n * `zip` - SCORM Package (e-learning content, currently in beta)\n * `odt` - OpenDocument Text Document (currently in beta)\n * `rtf` - Rich Text Format Document (currently in beta)\n * `resx` - .NET Resource Document (currently in beta)\n * `jpeg` / `jpg` / `png` - Image (currently in beta)" + "description": "The document translation API allows you to translate whole documents and supports the following file types and extensions:\n * `docx` - Microsoft Word Document\n * `pptx` - Microsoft PowerPoint Document\n * `xlsx` - Microsoft Excel Document\n * `xlsm` - Microsoft Excel Macro-Enabled Workbook\n * `pdf` - Portable Document Format\n * `htm / html` - HTML Document\n * `txt` - Plain Text Document\n * `xlf / xliff` - XLIFF Document (versions 1.2, 2.0, and 2.1)\n * `srt` - SRT Document\n * `vtt` - WebVTT Subtitle Document\n * `idml` - Adobe InDesign Markup Language\n * `xml` - XML Document\n * `json` - JSON Document\n * `yaml / yml` - YAML Document\n * `properties` - Java Properties Document\n * `strings` - iOS/macOS Strings Document\n * `md / markdown` - Markdown Document\n * `dita` - DITA topic (Darwin Information Typing Architecture)\n * `mif` - Adobe FrameMaker Interchange Format\n * `zip` - SCORM Package (e-learning content)\n * `odt` - OpenDocument Text Document\n * `rtf` - Rich Text Format Document\n * `resx` - .NET Resource Document\n * `jpeg` / `jpg` / `png` - Image" }, { "name": "RephraseText", @@ -1207,7 +1207,7 @@ "file": { "type": "string", "format": "binary", - "description": "The document file to be translated. The file name should be included in this part's content disposition. As an alternative, the filename parameter can be used. The following file types and extensions are supported:\n * `docx` - Microsoft Word Document\n * `pptx` - Microsoft PowerPoint Document\n * `xlsx` - Microsoft Excel Document\n * `xlsm` - Microsoft Excel Macro-Enabled Workbook (currently in beta)\n * `pdf` - Portable Document Format\n * `htm / html` - HTML Document\n * `txt` - Plain Text Document\n * `xlf / xliff` - XLIFF Document (versions 1.2, 2.0, and 2.1)\n * `srt` - SRT Document\n * `vtt` - WebVTT Subtitle Document (currently in beta)\n * `idml` - Adobe InDesign Markup Language\n * `xml` - XML Document\n * `json` - JSON Document\n * `yaml / yml` - YAML Document (currently in beta)\n * `properties` - Java Properties Document (currently in beta)\n * `strings` - iOS/macOS Strings Document (currently in beta)\n * `md / markdown` - Markdown Document (currently in beta)\n * `dita` - DITA topic (Darwin Information Typing Architecture)\n * `mif` - Adobe FrameMaker Interchange Format\n * `zip` - SCORM Package (e-learning content, currently in beta)\n * `odt` - OpenDocument Text Document (currently in beta)\n * `rtf` - Rich Text Format Document (currently in beta)\n * `resx` - .NET Resource Document (currently in beta)\n * `jpeg` / `jpg` / `png` - Image (currently in beta)" + "description": "The document file to be translated. The file name should be included in this part's content disposition. As an alternative, the filename parameter can be used. The following file types and extensions are supported:\n * `docx` - Microsoft Word Document\n * `pptx` - Microsoft PowerPoint Document\n * `xlsx` - Microsoft Excel Document\n * `xlsm` - Microsoft Excel Macro-Enabled Workbook\n * `pdf` - Portable Document Format\n * `htm / html` - HTML Document\n * `txt` - Plain Text Document\n * `xlf / xliff` - XLIFF Document (versions 1.2, 2.0, and 2.1)\n * `srt` - SRT Document\n * `vtt` - WebVTT Subtitle Document\n * `idml` - Adobe InDesign Markup Language\n * `xml` - XML Document\n * `json` - JSON Document\n * `yaml / yml` - YAML Document\n * `properties` - Java Properties Document\n * `strings` - iOS/macOS Strings Document\n * `md / markdown` - Markdown Document\n * `dita` - DITA topic (Darwin Information Typing Architecture)\n * `mif` - Adobe FrameMaker Interchange Format\n * `zip` - SCORM Package (e-learning content)\n * `odt` - OpenDocument Text Document\n * `rtf` - Rich Text Format Document\n * `resx` - .NET Resource Document\n * `jpeg` / `jpg` / `png` - Image" }, "filename": { "type": "string", diff --git a/api-reference/openapi.yaml b/api-reference/openapi.yaml index 6419488b..447eece8 100644 --- a/api-reference/openapi.yaml +++ b/api-reference/openapi.yaml @@ -30,27 +30,27 @@ tags: * `docx` - Microsoft Word Document * `pptx` - Microsoft PowerPoint Document * `xlsx` - Microsoft Excel Document - * `xlsm` - Microsoft Excel Macro-Enabled Workbook (currently in beta) + * `xlsm` - Microsoft Excel Macro-Enabled Workbook * `pdf` - Portable Document Format * `htm / html` - HTML Document * `txt` - Plain Text Document * `xlf / xliff` - XLIFF Document (versions 1.2, 2.0, and 2.1) * `srt` - SRT Document - * `vtt` - WebVTT Subtitle Document (currently in beta) + * `vtt` - WebVTT Subtitle Document * `idml` - Adobe InDesign Markup Language * `xml` - XML Document * `json` - JSON Document - * `yaml / yml` - YAML Document (currently in beta) - * `properties` - Java Properties Document (currently in beta) - * `strings` - iOS/macOS Strings Document (currently in beta) - * `md / markdown` - Markdown Document (currently in beta) + * `yaml / yml` - YAML Document + * `properties` - Java Properties Document + * `strings` - iOS/macOS Strings Document + * `md / markdown` - Markdown Document * `dita` - DITA topic (Darwin Information Typing Architecture) * `mif` - Adobe FrameMaker Interchange Format - * `zip` - SCORM Package (e-learning content, currently in beta) - * `odt` - OpenDocument Text Document (currently in beta) - * `rtf` - Rich Text Format Document (currently in beta) - * `resx` - .NET Resource Document (currently in beta) - * `jpeg` / `jpg` / `png` - Image (currently in beta) + * `zip` - SCORM Package (e-learning content) + * `odt` - OpenDocument Text Document + * `rtf` - Rich Text Format Document + * `resx` - .NET Resource Document + * `jpeg` / `jpg` / `png` - Image - name: RephraseText description: |- The `rephrase` endpoint is used to make corrections and adjustments to texts based on style or tone. @@ -1022,27 +1022,27 @@ paths: * `docx` - Microsoft Word Document * `pptx` - Microsoft PowerPoint Document * `xlsx` - Microsoft Excel Document - * `xlsm` - Microsoft Excel Macro-Enabled Workbook (currently in beta) + * `xlsm` - Microsoft Excel Macro-Enabled Workbook * `pdf` - Portable Document Format * `htm / html` - HTML Document * `txt` - Plain Text Document * `xlf / xliff` - XLIFF Document (versions 1.2, 2.0, and 2.1) * `srt` - SRT Document - * `vtt` - WebVTT Subtitle Document (currently in beta) + * `vtt` - WebVTT Subtitle Document * `idml` - Adobe InDesign Markup Language * `xml` - XML Document * `json` - JSON Document - * `yaml / yml` - YAML Document (currently in beta) - * `properties` - Java Properties Document (currently in beta) - * `strings` - iOS/macOS Strings Document (currently in beta) - * `md / markdown` - Markdown Document (currently in beta) + * `yaml / yml` - YAML Document + * `properties` - Java Properties Document + * `strings` - iOS/macOS Strings Document + * `md / markdown` - Markdown Document * `dita` - DITA topic (Darwin Information Typing Architecture) * `mif` - Adobe FrameMaker Interchange Format - * `zip` - SCORM Package (e-learning content, currently in beta) - * `odt` - OpenDocument Text Document (currently in beta) - * `rtf` - Rich Text Format Document (currently in beta) - * `resx` - .NET Resource Document (currently in beta) - * `jpeg` / `jpg` / `png` - Image (currently in beta) + * `zip` - SCORM Package (e-learning content) + * `odt` - OpenDocument Text Document + * `rtf` - Rich Text Format Document + * `resx` - .NET Resource Document + * `jpeg` / `jpg` / `png` - Image filename: type: string description: The name of the uploaded file. Can be used as an alternative diff --git a/docs/best-practices/document-translations.mdx b/docs/best-practices/document-translations.mdx index c7895ff6..2154d34a 100644 --- a/docs/best-practices/document-translations.mdx +++ b/docs/best-practices/document-translations.mdx @@ -15,7 +15,7 @@ For DOCX and PPTX, our .NET, PHP and NodeJS client libraries offer functionality This allows users to translate files that might hit the size limit. ### Billing minimums -Every submitted document of type `.pptx`, `.docx`, `.doc`, `.xlsx`, or `.pdf` is billed a minimum of 50,000 characters on DeepL API plans, no matter how many characters the document contains. Formats currently in beta are not billed and are not subject to this minimum. +Documents of type `.docx`, `.doc`, `.pptx`, `.xlsx`, `.xlsm`, `.pdf`, `.odt`, `.rtf`, SCORM (`.zip`), `.jpeg`/`.jpg`/`.png`, `.idml`, and `.mif` are billed a minimum of 50,000 characters on DeepL API plans, no matter how many characters the document contains. Text-like formats (`.txt`, `.htm`/`.html`, `.xml`, `.json`, `.yaml`/`.yml`, `.properties`, `.strings`, `.md`/`.markdown`, `.dita`, `.xlf`/`.xliff`, `.srt`, `.vtt`, `.resx`) are billed for their exact character count with no minimum. ### One source/target language pair per upload The `source_lang` and `target_lang` values on the request apply to the entire uploaded file. For most formats, keep each upload to a single source language for consistent results — behavior on content that isn't in the selected source language is not guaranteed. @@ -74,14 +74,14 @@ Each supported format has behaviors and constraints worth knowing before you upl - Some valid FrameMaker 10 MIF files may fail with HTTP 500 — try re-saving from a newer FrameMaker version. - MIF does not use `translate="no"`. Protect content via FrameMaker conditional text or character formatting. -**XLSM** (currently in beta) +**XLSM** - Cell text is translated across all sheets; rich text formatting, merged cells, and multi-sheet layouts are preserved. Numbers and dates are left unchanged. - Macros are preserved byte-for-byte and never translated. The VBA project is carried through untouched, so user-facing strings inside macro code remain in the source language. - Formulas are preserved verbatim and cached values are kept as-is. - Lookup formulas (`VLOOKUP`, `MATCH`, `INDEX`) whose lookup key is a text literal typed into the formula keep that literal in the source language while the table they search is translated, so the lookup can stop matching and return `#N/A` after recalculation. Key lookups off a cell reference (e.g. `=VLOOKUP(D1,...)`) instead. - Files with no translatable text are rejected with `No translatable text can be extracted from the document.` This does not mean the file is malformed. -**SCORM (`.zip`)** (currently in beta) +**SCORM (`.zip`)** - The `.zip` must be a valid SCORM package (SCORM 1.2 or SCORM 2004) with `imsmanifest.xml` at the root of the archive. AICC, xAPI (Tin Can), and cmi5 packages are not supported and are rejected. - Course titles in `imsmanifest.xml` and lesson content in the package's HTML files are translated. Manifest identifiers, file paths, and HTML markup are preserved exactly. - Audio and video files (MP3, MP4, WAV, images) are preserved byte-for-byte. DeepL does not transcribe or translate media content. @@ -89,48 +89,48 @@ Each supported format has behaviors and constraints worth knowing before you upl - The manifest must be under 4 MB. A larger `imsmanifest.xml` is rejected. - Non-SCORM `.zip` uploads are rejected with `400 Invalid or missing file extension`. -**VTT (WebVTT)** (currently in beta) +**VTT (WebVTT)** - Cue text is translated; cue timings, identifiers, settings lines, and `WEBVTT` headers are preserved so subtitles stay in sync with the original media. - Inline styling tags (e.g. ``, ``, karaoke timestamps) are preserved. Review their placement, since translated text length differs from the source. - Files with no translatable text are rejected. -**YAML / YML** (currently in beta) +**YAML / YML** - String values are translated at every level of nesting; keys, numbers, booleans, `null` values, comments, and indentation structure are preserved. - Placeholders and escape sequences (`\n`, `\t`, etc.) are preserved. - Files with no translatable text are rejected. - Malformed YAML (inconsistent indentation, unquoted special characters) returns an error. Validate before uploading. -**Java `.properties`** (currently in beta) +**Java `.properties`** - Property values are translated; keys and separators are preserved. Comment lines (`#` or `!`) are not translated. - Placeholders (`{0}`, `%s`, `%d`) are normally preserved. Verify them after translation before shipping. - Escaped characters (`\n`, `\t`, `\:`) are preserved. - Files with no translatable text are returned unchanged. -**iOS/macOS `.strings`** (currently in beta) +**iOS/macOS `.strings`** - String values are translated; keys and the `"key" = "value";` structure are preserved. - Format specifiers (`%@`, `%d`, positional specifiers like `%1$@`) are normally preserved. Verify them after translation before shipping. - Escaped characters (`\n`, `\"`, `\\`) are preserved. - Files with no translatable text are returned unchanged. -**Markdown (`.md` / `.markdown`)** (currently in beta) +**Markdown (`.md` / `.markdown`)** - Paragraphs, headings, list items, blockquotes, table cell content, and image alt text are translated. URLs and link targets are not, only the link label text is. - YAML front matter is not translated. **Known issue:** the `---` delimiters that open and close the front matter block are currently dropped from the translated file, which can fuse the metadata into the first paragraph. Re-add the `---` lines after download, or move the front matter out of the file before uploading. - HTML blocks embedded in Markdown are processed via an HTML sub-filter. Results may vary for complex inline HTML. - Markdown formatting (bold, italic, headings, lists) is preserved. - Malformed Markdown is accepted and translated as-is (not validated for well-formedness). -**RESX** (currently in beta) +**RESX** - String values in `` elements are translated; element names, IDs, and XML structure are preserved. Comments in `` elements are not translated. - Placeholders (`{0}`, `%s`) are normally preserved. Verify them after translation before shipping. - Files with no translatable text are returned unchanged. -**ODT** (currently in beta) +**ODT** - Body text, headings, table content, footnotes, endnotes, annotations, and document metadata are translated. - Accept or reject all tracked changes before uploading. Deleted text that has not been formally removed may still be extracted and translated. - Consecutive tabs may be dropped during translation. Review content that relies on tab-based alignment. - If the target language requires characters outside the document's fonts, they may not render correctly. Check fonts after translation. -**RTF** (currently in beta) +**RTF** - Body text in paragraphs, headings, list items, table cells, footnotes, and endnotes is translated. RTF control words, groups, and formatting tokens (`\b`, `\i`, `\par`, `\fonttbl`, etc.) are preserved untouched. - Non-ASCII characters are written as `\uXXXX?` escape sequences. Old RTF readers that ignore `\u` escapes will show only the ASCII fallback character. Open the result in a modern reader (Word 2007+, LibreOffice). - Embedded objects (images, OLE objects, embedded fonts) are preserved as binary blocks and not modified. diff --git a/docs/getting-started/about.mdx b/docs/getting-started/about.mdx index 3cb9ac46..50b8781c 100644 --- a/docs/getting-started/about.mdx +++ b/docs/getting-started/about.mdx @@ -23,7 +23,7 @@ In addition, many leading computer-assisted translation (CAT) tool providers hav ## Why the DeepL API? -- **High-quality text and document translations**: DeepL [consistently outperforms the competition](https://www.deepl.com/quality.html) in translation quality, and not only for text translation. The API also supports [many document, publishing, and localization formats](/api-reference/document/upload-and-translate-a-document) including DOCX, PPTX, XLSX, PDF, HTML, IDML, XLIFF, XML, JSON, DITA, and MIF, plus beta support for XLSM, SCORM, WebVTT, YAML, Markdown, RESX, ODT, RTF, and more. +- **High-quality text and document translations**: DeepL [consistently outperforms the competition](https://www.deepl.com/quality.html) in translation quality, and not only for text translation. The API also supports [many document, publishing, and localization formats](/api-reference/document/upload-and-translate-a-document) including DOCX, PPTX, XLSX, PDF, HTML, IDML, XLIFF, XML, JSON, DITA, and MIF, plus XLSM, SCORM, WebVTT, YAML, Markdown, RESX, ODT, RTF, and PNG/JPG image translation. - **Maximum data security**: With DeepL API paid plans, texts aren’t saved on persistent storage and aren’t used to train our models. And DeepL adheres strictly to EU data protection laws and ISO 27001. [Learn more about data security at DeepL](https://www.deepl.com/pro-data-security/). - **Customization with glossaries**: [Specify your own translations for words and phrases](/docs/customize/managing-glossaries), and customize your translations consistently and at scale. diff --git a/docs/resources/roadmap-and-release-notes.mdx b/docs/resources/roadmap-and-release-notes.mdx index 65d3ed35..34d36de2 100644 --- a/docs/resources/roadmap-and-release-notes.mdx +++ b/docs/resources/roadmap-and-release-notes.mdx @@ -13,6 +13,11 @@ rss: true - [Custom instructions](/docs/customize/custom-instructions) are natural language directives, such as "Use a friendly, diplomatic tone", that guide how DeepL translates. [`POST /v2/document`](/api-reference/document/upload-and-translate-a-document) now accepts them in the `custom_instructions` parameter, as they already work in text translation. - Send the instructions as a JSON array of strings in a single form field, for example `["Use a friendly, diplomatic tone"]`. The same limits as text translation apply: up to 10 instructions, each with a maximum of 300 characters. - The upload is rejected with `400` if the value is not a JSON array of strings, exceeds these limits, or is combined with `style_profile_id`. + +## November 2 - New File Formats Generally Available +- Ten formats introduced in beta on September 29 — `xlsm` (macro-enabled Excel), `zip` (SCORM e-learning packages), `vtt` (WebVTT subtitles), `yaml` / `yml`, `properties` (Java properties), `strings` (iOS/macOS strings), `md` / `markdown`, `resx` (.NET resources), `odt` (OpenDocument Text), and `rtf` (Rich Text Format) — plus `jpeg` / `png` image translation, are now generally available in [`POST /v2/document`](/api-reference/document/upload-and-translate-a-document). They are no longer marked beta. +- During beta these formats were not billed. They now count toward your character usage, with the billing rules below. +- Billing: document-like formats (`.docx`, `.doc`, `.pptx`, `.xlsx`, `.xlsm`, `.pdf`, `.odt`, `.rtf`, SCORM `.zip`, `.jpeg`/`.jpg`/`.png`, `.idml`, `.mif`) are billed a minimum of 50,000 characters per document. Text-like formats (`.txt`, `.htm`/`.html`, `.xml`, `.json`, `.yaml`/`.yml`, `.properties`, `.strings`, `.md`/`.markdown`, `.dita`, `.xlf`/`.xliff`, `.srt`, `.vtt`, `.resx`) are billed for their exact character count. See [Billing minimums](/docs/best-practices/document-translations#billing-minimums). diff --git a/docs/resources/usage-limits.mdx b/docs/resources/usage-limits.mdx index 1b1366b5..a905d0ab 100644 --- a/docs/resources/usage-limits.mdx +++ b/docs/resources/usage-limits.mdx @@ -19,7 +19,7 @@ The maximum upload size and the per-document character limit depend on the forma | Word (.docx / .doc) | 10 MB
500,000 characters | 100 MB
5 million characters | | PowerPoint (.pptx) | 10 MB
500,000 characters | 100 MB
5 million characters | | Excel (.xlsx) | 10 MB
500,000 characters | 30 MB
1 million characters | -| Excel Macro-Enabled (.xlsm)\*\* | 10 MB
500,000 characters | 30 MB
1 million characters | +| Excel Macro-Enabled (.xlsm) | 10 MB
500,000 characters | 30 MB
1 million characters | | PDF (.pdf) | 10 MB
500,000 characters | 100 MB
5 million characters | | Text (.txt) | 1 MB
500,000 characters | 1 MB
1 million characters | | HTML (.html) | 5 MB
500,000 characters | 5 MB
1 million characters | @@ -27,22 +27,23 @@ The maximum upload size and the per-document character limit depend on the forma | MIF (.mif) | 10 MB
500,000 characters | 30 MB
1 million characters | | XML (.xml) | 10 MB
500,000 characters | 10 MB
1 million characters | | JSON (.json) | 1 MB
500,000 characters | 1 MB
1 million characters | -| YAML (.yaml / .yml)\*\* | 1 MB
500,000 characters | 1 MB
1 million characters | -| Java Properties (.properties)\*\*| 1 MB
500,000 characters | 1 MB
1 million characters | -| iOS/macOS Strings (.strings)\*\*| 1 MB
500,000 characters | 1 MB
1 million characters | -| Markdown (.md / .markdown)\*\* | 1 MB
500,000 characters | 1 MB
1 million characters | +| YAML (.yaml / .yml) | 1 MB
500,000 characters | 1 MB
1 million characters | +| Java Properties (.properties) | 1 MB
500,000 characters | 1 MB
1 million characters | +| iOS/macOS Strings (.strings) | 1 MB
500,000 characters | 1 MB
1 million characters | +| Markdown (.md / .markdown) | 1 MB
500,000 characters | 1 MB
1 million characters | | DITA (.dita) | 5 MB
500,000 characters | 5 MB
1 million characters | | XLIFF (.xlf/.xliff)\* | 10 MB
500,000 characters | 10 MB
1 million characters | | SRT (.srt) | 150 KB
500,000 characters | 150 KB
1 million characters | -| WebVTT (.vtt)\*\* | 150 KB
500,000 characters | 150 KB
1 million characters | -| SCORM (.zip)\*\* | 10 MB
500,000 characters | 10 MB
1 million characters | -| RESX (.resx)\*\* | 1 MB
500,000 characters | 1 MB
1 million characters | -| ODT (.odt)\*\* | 10 MB
500,000 characters | 30 MB
1 million characters | -| RTF (.rtf)\*\* | 10 MB
500,000 characters | 30 MB
1 million characters | -| Images (.jpeg/.png)\*\* | 3 MB
500,000 characters | 3 MB
1 million characters | - -*DeepL supports XLIFF versions 1.2, 2.0, and 2.1 (2.1 shares the 2.0 core namespace).
-**Currently in Beta. During the Beta phase, characters translated in these file formats are not billed and not counted against your character threshold. +| WebVTT (.vtt) | 150 KB
500,000 characters | 150 KB
1 million characters | +| SCORM (.zip) | 10 MB
500,000 characters | 10 MB
1 million characters | +| RESX (.resx) | 1 MB
500,000 characters | 1 MB
1 million characters | +| ODT (.odt) | 10 MB
500,000 characters | 30 MB
1 million characters | +| RTF (.rtf) | 10 MB
500,000 characters | 30 MB
1 million characters | +| Images (.jpeg/.jpg/.png) | 3 MB
500,000 characters | 3 MB
1 million characters | + +*DeepL supports XLIFF versions 1.2, 2.0, and 2.1 (2.1 shares the 2.0 core namespace). + +Document-like formats (`.docx`, `.doc`, `.pptx`, `.xlsx`, `.xlsm`, `.pdf`, `.odt`, `.rtf`, SCORM `.zip`, `.jpeg`/`.jpg`/`.png`, `.idml`, `.mif`) are billed a minimum of 50,000 characters per document; text-like formats (`.txt`, `.htm`/`.html`, `.xml`, `.json`, `.yaml`/`.yml`, `.properties`, `.strings`, `.md`/`.markdown`, `.dita`, `.xlf`/`.xliff`, `.srt`, `.vtt`, `.resx`) are billed for their exact character count. See [Document translations](/docs/best-practices/document-translations#billing-minimums). These limits apply to documents submitted through the DeepL API. Uploads through the DeepL web app and desktop apps use separate limits. diff --git a/docs/translate/translate-documents-quickstart.mdx b/docs/translate/translate-documents-quickstart.mdx index 1ef0e1cc..0732c119 100644 --- a/docs/translate/translate-documents-quickstart.mdx +++ b/docs/translate/translate-documents-quickstart.mdx @@ -113,7 +113,7 @@ Open `order-confirmation-de.docx` and you'll find the German translation with th For privacy reasons, the document is removed from DeepL's servers once you download it, so it can't be downloaded twice. To translate the same file again, start over from step 1. Download promptly: leaving too many finished translations unretrieved can cause new upload requests to fail with HTTP 429. -Every submitted `docx`, `doc`, `pptx`, `xlsx`, or `pdf` file is billed a minimum of 50,000 characters, regardless of how much text it contains. +Every submitted `docx`, `doc`, `pptx`, `xlsx`, `xlsm`, `pdf`, `odt`, `rtf`, SCORM `zip`, `jpeg`/`jpg`/`png`, `idml`, or `mif` file is billed a minimum of 50,000 characters, regardless of how much text it contains. Text-like formats are billed for their exact character count. ## Or: one call with a client library