Releases: DeepL/deepl-python
Releases · DeepL/deepl-python
Release list
v1.31.0
Added
- Added support for using multiple glossaries via the
glossary_idsparameter
(up to 5 glossaries) intranslate_text(),translate_document(),
translate_document_upload(), andtranslate_document_from_filepath(). - Added support for style rules in document translation via the
style_rule
parameter intranslate_document(),translate_document_upload(), and
translate_document_from_filepath(). - Added support for translation memories in document translation via the
translation_memoryandtranslation_memory_thresholdparameters in
translate_document(),translate_document_upload(), and
translate_document_from_filepath(). - Added
--glossary-idsCLI argument for thetextanddocumentcommands,
allowing up to 5 glossaries to be used per translation. - Added
--style-id,--translation-memory-id, and
--translation-memory-thresholdCLI arguments to thedocumentcommand. - Added support for the translation memory management APIs:
get_translation_memory(),list_translation_memory_segments(),
delete_translation_memory(),create_translation_memory_import(),
upload_translation_memory_file(),create_translation_memory_export(),
get_translation_memory_job(),
wait_until_translation_memory_job_done(), and
download_translation_memory_export(), along with the
import_translation_memory_from_filepath()and
export_translation_memory_to_filepath()convenience functions that create
the job, transfer the TMX file, and wait for the job to finish. Because the
API detects the file upload asynchronously, an import job keeps reporting
awaiting_inputfor a while after the upload; the wait loop polls through
that status, so passtimeout_sto bound the wait. - Added the
TranslationMemorySegments,TranslationMemorySegment,
TranslationMemoryTargetSegment,TranslationMemoryImport,
TranslationMemoryExport,TranslationMemoryJob, and
TranslationMemoryJobResulttypes. - Added
creation_timeandupdated_timeproperties to
TranslationMemoryInfo. - Added the
translation-memoryCLI command with thelist,get,
segments,import,export,job, anddeletesubcommands.
v1.30.0
Added
- Added support for translation memories in text translation via
translation_memoryandtranslation_memory_thresholdparameters in
translate_text(). - Added
list_translation_memories()method to theDeepLClientclass for
listing available translation memories. - Added
--translation-memory-idand--translation-memory-thresholdCLI
arguments.
Fixed
- Fixed "gitlab release" CI job to explicitly set the release-cli image, avoiding issues with missing
$HOMEfrom the global image.
v1.29.0
Added
- Added new language constants from January 2026 API release of 81 new languages.
- Added support for style rules CRUD endpoints in the
DeepLClientclass:
create_style_rule(),get_style_rule(),update_style_rule_name(),
update_style_rule_configured_rules(), anddelete_style_rule(). - Added support for style rule custom instruction CRUD endpoints in the
DeepLClientclass:create_style_rule_custom_instruction(),
get_style_rule_custom_instruction(),
update_style_rule_custom_instruction(), and
delete_style_rule_custom_instruction().
Please refer to the README for usage instructions.
Changed
- Updated formality tests to accept either formal or informal output when using default formality,
since the default formality is automatic.
v1.28.0
Changed
- Updated three tests to be less flakey and reflect new behavior regarding the model type.
- Improved
NotFoundExceptionerror message by removing the misleading "check server_url" suggestion.
Fixed
- Fixed a bug where translating with style rules would sometimes incorrectly result in
a "target_lang must match style rule language" error
Security
- Updated dependencies to fix CVE-2025-66418 and CVE-2025-66471
v1.27.0
Added
- Added
tag_handling_versionparameter totranslate_text()to specify which version
of the tag handling algorithm to use. Options arev1andv2. - Added an example CLI script for realtime audio translation using DeepL's Voice API.
v1.26.0
Added
- Added
custom_instructionsparameter totranslate_text()to customize translation behavior with up to 10 instructions (max 300 characters each). Only supported for target languages:de,en,es,fr,it,ja,ko,zhand their variants. Note: using thecustom_instructionsparameter will use thequality_optimizedmodel type as the default. Requests combiningcustom_instructionsand thelatency_optimizedmodel type will be rejected.
v1.25.0
- Added support for the
GET /v3/style_rulesendpoint in the client library, the implementation can be found in theDeepLClientclass. Please refer to the README for usage instructions - Added
style_idoption totranslate_text()which allows text translation with style rules.
v1.24.0
Changed
extra_body_parameterswill now overwrite already set HTTP parameters
v1.23.0
Added
- Added feature to add arbitrary body parameters in
translate_text
Deprecated
- Dropped support for Python 3.8 and older.
Security
- Updated
requestsminimum version to 2.32.4 to resolve security advisories
CVE-2024-47081 and CVE-2024-35195.
v1.22.0
Added
- Added support for the /v3 Glossary APIs in the client library while providing backwards compatibility for the previous /v2 Glossary endpoints. Please refer to the README for usage instructions.