docs: new file formats GA — drop beta labels, document the 50k billing floor

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",

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

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,63 +74,63 @@ 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.
 - Zip the contents, not the folder. `imsmanifest.xml` must sit at the root of the archive, exactly one. An archive that starts with a folder (e.g. `course/imsmanifest.xml`) is rejected.
 - 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. `<c>`, `<v Speaker>`, 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 `<data>` elements are translated; element names, IDs, and XML structure are preserved. Comments in `<comment>` 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.

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.