Skip to content

Releases: DeepL/deepl-python

v1.31.0

Choose a tag to compare

@BriannaDelgado BriannaDelgado released this 12 Aug 02:39
v1.31.0
82af17c

Added

  • Added support for using multiple glossaries via the glossary_ids parameter
    (up to 5 glossaries) in translate_text(), translate_document(),
    translate_document_upload(), and translate_document_from_filepath().
  • Added support for style rules in document translation via the style_rule
    parameter in translate_document(), translate_document_upload(), and
    translate_document_from_filepath().
  • Added support for translation memories in document translation via the
    translation_memory and translation_memory_threshold parameters in
    translate_document(), translate_document_upload(), and
    translate_document_from_filepath().
  • Added --glossary-ids CLI argument for the text and document commands,
    allowing up to 5 glossaries to be used per translation.
  • Added --style-id, --translation-memory-id, and
    --translation-memory-threshold CLI arguments to the document command.
  • 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_input for a while after the upload; the wait loop polls through
    that status, so pass timeout_s to bound the wait.
  • Added the TranslationMemorySegments, TranslationMemorySegment,
    TranslationMemoryTargetSegment, TranslationMemoryImport,
    TranslationMemoryExport, TranslationMemoryJob, and
    TranslationMemoryJobResult types.
  • Added creation_time and updated_time properties to
    TranslationMemoryInfo.
  • Added the translation-memory CLI command with the list, get,
    segments, import, export, job, and delete subcommands.

v1.30.0

Choose a tag to compare

@BriannaDelgado BriannaDelgado released this 09 Apr 18:43
v1.30.0
84abaee

Added

  • Added support for translation memories in text translation via
    translation_memory and translation_memory_threshold parameters in
    translate_text().
  • Added list_translation_memories() method to the DeepLClient class for
    listing available translation memories.
  • Added --translation-memory-id and --translation-memory-threshold CLI
    arguments.

Fixed

  • Fixed "gitlab release" CI job to explicitly set the release-cli image, avoiding issues with missing $HOME from the global image.

v1.29.0

Choose a tag to compare

@JanEbbing JanEbbing released this 30 Mar 09:50
v1.29.0
65fc7e2

Added

  • Added new language constants from January 2026 API release of 81 new languages.
  • Added support for style rules CRUD endpoints in the DeepLClient class:
    create_style_rule(), get_style_rule(), update_style_rule_name(),
    update_style_rule_configured_rules(), and delete_style_rule().
  • Added support for style rule custom instruction CRUD endpoints in the
    DeepLClient class: 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

Choose a tag to compare

@BriannaDelgado BriannaDelgado released this 05 Feb 19:23
v1.28.0
2b66bb1

Changed

  • Updated three tests to be less flakey and reflect new behavior regarding the model type.
  • Improved NotFoundException error 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

v1.27.0

Choose a tag to compare

@BriannaDelgado BriannaDelgado released this 21 Jan 16:59
83ea6e4

Added

  • Added tag_handling_version parameter to translate_text() to specify which version
    of the tag handling algorithm to use. Options are v1 and v2.
  • Added an example CLI script for realtime audio translation using DeepL's Voice API.

v1.26.0

Choose a tag to compare

@BriannaDelgado BriannaDelgado released this 08 Dec 21:19
v1.26.0
b6fd569

Added

  • Added custom_instructions parameter to translate_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, zh and their variants. Note: using the custom_instructions parameter will use the quality_optimized model type as the default. Requests combining custom_instructions and the latency_optimized model type will be rejected.

v1.25.0

Choose a tag to compare

@BriannaDelgado BriannaDelgado released this 12 Nov 19:12
v1.25.0
705a461
  • Added support for the GET /v3/style_rules endpoint in the client library, the implementation can be found in the DeepLClient class. Please refer to the README for usage instructions
  • Added style_id option to translate_text() which allows text translation with style rules.

v1.24.0

Choose a tag to compare

@daniel-jones-dev daniel-jones-dev released this 04 Nov 14:52
b766762

Changed

  • extra_body_parameters will now overwrite already set HTTP parameters

v1.23.0

Choose a tag to compare

@JanEbbing JanEbbing released this 07 Oct 08:20
v1.23.0
36cf003

Added

  • Added feature to add arbitrary body parameters in translate_text

Deprecated

  • Dropped support for Python 3.8 and older.

Security

v1.22.0

Choose a tag to compare

@BriannaDelgado BriannaDelgado released this 30 Apr 17:42
v1.22.0
632bbaa

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.