deepl-rb 3.1.0 → 3.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1de43b1593c5b5d4236c0b064c08436ab57fe13bf3fdc29069220fd899ca8e1d
-  data.tar.gz: a486d446fa3bebddbf3fd6aa468300bead03eafe8bc075c33a28d80be6e555b8
+  metadata.gz: ce04c17b4585b9813713f61db8fe35e3a61b777c48ec22011f81b7febe106527
+  data.tar.gz: 3c4432516a14b2fb0e8886f2ff3e6d31c5ba5c88590d4e28a9631fc0a233f724
 SHA512:
-  metadata.gz: ca167089f7a190915436fb316a8a82aa69bf8093316b4074c6536bb21e002811d9bdd57fc8711eeb634025b094a9fe17e2b057eee5ea5d2499539060e09b8ebd
-  data.tar.gz: 1c63cd745170652f01a2335cc064ceb0266c1584a19bd1fcd6683c6d461241b646d33df0b3e36f516e1dff6a1d6158e706994b862b6bd8d671b1db399cabfa03
+  metadata.gz: 8a736f2b2cc257c26cd47e67bdbdcbc89afbb6de444176f0dab5b0a470fe2c713e3c32396391a05c007ddfbfbbc80953b0f6c6afb1fdf9b138c0eca97ae02a52
+  data.tar.gz: 1828bdede7c38bec246302645e39ec7f01950096f3c52fb1b119766bbdf11b6c2b6d3ab881ebdf2875f736ab8f47778e87abcb5f107ca2ef6f4848c66d11d680

data/.gitlab-ci.yml

@@ -1,5 +1,6 @@
 # Note: This GitLab CI configuration is used for internal testing, users can ignore it.
 include:
+  - template: Security/SAST.gitlab-ci.yml
   - project: '${CI_PROJECT_NAMESPACE}/ci-libs-for-client-libraries'
     file:
       - '/${CI_PROJECT_NAME}/.gitlab-ci.yml'
@@ -7,6 +8,7 @@ include:
     file:
       - '/templates/.buildkit.yml'
       - '/templates/.secret-detection.yml'
+      - '/templates/.gitlab-release.yml'
 
 # Global --------------------------
 
@@ -16,11 +18,14 @@ workflow:
     - if: $CI_COMMIT_TAG
     - if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH'
 
+variables:
+  GITLAB_ADVANCED_SAST_ENABLED: 'true'
+
 stages:
   - install
   - check
   - test
-#  - publish
+  - publish # Only for internal tracking
 
 
 before_script:
@@ -82,6 +87,29 @@ license_check:
     - ./license_checker.sh '*.rb' | tee license_check_output.txt
     - '[ ! -s license_check_output.txt ]'
 
+gitlab-advanced-sast:
+  stage: check
+  before_script:
+    - ''
+  rules:
+    - when: always
+  variables:
+    SAST_EXCLUDED_PATHS: '$DEFAULT_SAST_EXCLUDED_PATHS,/spec'
+    GIT_STRATEGY: clone
+    KUBERNETES_HELPER_MEMORY_LIMIT: 8Gi
+    SAST_SCANNER_ALLOWED_CLI_OPTS: --multi-core 8
+
+semgrep-sast:
+  stage: check
+  before_script:
+    - ''
+  rules:
+    - when: always
+  variables:
+    SAST_EXCLUDED_PATHS: '$DEFAULT_SAST_EXCLUDED_PATHS,/spec'
+    GIT_STRATEGY: clone
+    KUBERNETES_MEMORY_LIMIT: 8Gi
+
 
 # stage: test ----------------------
 
@@ -133,3 +161,12 @@ test_manual:
   extends: .test_base
   rules:
     - if: $CI_PIPELINE_SOURCE != "schedule"
+
+
+# stage: publish ----------------------
+
+gitlab release:
+  stage: publish
+  extends: .create_gitlab_release
+  rules:
+    - if: '$CI_COMMIT_TAG =~ /^v[0-9]+\.[0-9]+\.[0-9]+$/'

data/CHANGELOG.md

@@ -4,55 +4,69 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
 
-## [3.1.0]
+## [3.3.0] - 2025-11-04
 ### Added
-* Added `model_type` option to `translate()` to use models with higher
+- Added `extra_body_parameters` option to text and document translation methods to pass arbitrary parameters in the request body. This can be used to access beta features or override built-in parameters (such as `target_lang`, `source_lang`, etc.).
+- Added `rephrase` functionality to the top-level `DeepL` module for convenience.
+  * Thanks to [341bms](https://github.com/341bms) in [#14](https://github.com/DeepLcom/deepl-rb/issues/14) for the report!
+
+## [3.2.0] - 2025-01-15
+### Added
+- Added `rephrase` functionality to get a new version of submitted text with various possible styles or tones applied
+- Added `DeepL::Constants` namespace and associated constant values for options possibilities
+
+## [3.1.0] - 2024-11-15
+### Added
+- Added `model_type` option to `translate()` to use models with higher
   translation quality (available for some language pairs), or better latency.
   Options are `'quality_optimized'`, `'latency_optimized'`, and  `'prefer_quality_optimized'`
-* Added the `model_type_used` field to the `translate()` response, that
+- Added the `model_type_used` field to the `translate()` response, that
   indicates the translation model used when the `model_type` option is
   specified.
 
-
 ## [3.0.2] - 2024-10-02
 ### Added
-* Added doc example and tests for context parameter
+- Added doc example and tests for context parameter
+
 ### Fixed
-* Fix metadata displayed on RubyGems.org for this library.
-* Fixed library version sent in the `User-Agent` string.
+- Fix metadata displayed on RubyGems.org for this library.
+- Fixed library version sent in the `User-Agent` string.
 
 ## [3.0.1] - 2024-09-23
 ### Fixed
-* `document.translate_document` required a filename, this is now optional. The example in the README now works.
+- `document.translate_document` required a filename, this is now optional. The example in the README now works.
 
 ## [3.0.0] - 2024-09-20
 Beginning with version 3, deepl-rb is officially supported by DeepL, and maintained together with [Daniel Herzog](mailto:info@danielherzog.es) the developer of earlier versions of this library.
 The change in major version is only due to the change in maintainership, there is no migration necessary from v2 to v3.
+
 ### Added
-* Added rubocop-rspec linting for rspec test files
-* Added document translation to the ruby CL
-* Added possibility to use one HTTP session for multiple calls
-* Added platform and ruby version information to the user-agent string that is sent with API calls, along with an opt-out
-* Added support for logging of HTTP requests
-* Added support for using a proxy and a custom certificate file
-* Added a gitlab CI pipeline
+- Added rubocop-rspec linting for rspec test files
+- Added document translation to the ruby CL
+- Added possibility to use one HTTP session for multiple calls
+- Added platform and ruby version information to the user-agent string that is sent with API calls, along with an opt-out
+- Added support for logging of HTTP requests
+- Added support for using a proxy and a custom certificate file
+- Added a gitlab CI pipeline
+
 ### Changed
-* HTTP requests to the DeepL API now use `application/json`, rather than `application/www-form-unencoded`
-* HTTP requests now automatically retry on transient failures, using exponential backoff
-### Deprecated
+- HTTP requests to the DeepL API now use `application/json`, rather than `application/www-form-unencoded`
+- HTTP requests now automatically retry on transient failures, using exponential backoff
+
 ### Removed
-* Removed CircleCI and CodeCov upload
-### Fixed
-### Security
+- Removed CircleCI and CodeCov upload
 
 ## [2.5.3] - 2022-09-26
 ### Fixed
-* Make RequestEntityTooLarge error message more clear
-
+- Make RequestEntityTooLarge error message more clear
 
+[Unreleased]: https://github.com/DeepLcom/deepl-rb/compare/v3.3.0...HEAD
+[3.3.0]: https://github.com/DeepLcom/deepl-rb/compare/v3.2.0...v3.3.0
+[3.2.0]: https://github.com/DeepLcom/deepl-rb/compare/v3.1.0...v3.2.0
 [3.1.0]: https://github.com/DeepLcom/deepl-rb/compare/v3.0.2...v3.1.0
 [3.0.2]: https://github.com/DeepLcom/deepl-rb/compare/v3.0.1...v3.0.2
 [3.0.1]: https://github.com/DeepLcom/deepl-rb/compare/v3.0.0...v3.0.1
 [3.0.0]: https://github.com/DeepLcom/deepl-rb/compare/v2.5.3...v3.0.0
-[2.5.3]: https://github.com/DeepLcom/deepl-rb/compare/v2.5.2...v2.5.3
+[2.5.3]: https://github.com/DeepLcom/deepl-rb/releases/tag/v2.5.3

data/README.md

@@ -167,6 +167,38 @@ The following parameters will be automatically converted:
 | `formality`           | No conversion applied
 | `glossary_id`         | No conversion applied
 | `context`             | No conversion applied
+| `extra_body_parameters` | Hash of extra parameters to pass in the body of the HTTP request. Can be used to access beta features, or to override built-in parameters for testing purposes. Extra parameters can override keys explicitly set by the client.
+
+### Rephrase Text
+
+To rephrase or improve text, including changing the writing style or tone of the text, use the `rephrase` method:
+
+```rb
+rephrased_text = DeepL.rephrase 'you will acquire new rephrased text', 'EN'
+
+puts rephrased_text.class
+# => DeepL::Resources::Text
+puts rephrased_text.text
+# => 'You get new rephrased text.'
+```
+
+As with translate, the text input can be a single string or an array of strings.
+
+You can use the additional arguments to specify the writing style or tone you want for the rephrased text:
+
+```rb
+rephrased_text = DeepL.rephrase 'you will acquire new rephrased text', 'EN', 'casual'
+
+puts rephrased_text.text
+# => 'You'll get new, rephrased text.'
+```
+
+```rb
+rephrased_text = DeepL.rephrase 'you will acquire new rephrased text', 'EN', nil, 'friendly'
+
+puts rephrased_text.text
+# => 'You'll get to enjoy new, rephrased text!'
+```
 
 ### Glossaries
 
@@ -291,6 +323,18 @@ doc_status = doc_handle.wait_until_document_translation_finished # alternatively
 DeepL.document.download(doc_handle, '/path/to/translated_document.pdf') unless doc_status.error?
 ```
 
+You can also pass additional options to document translation methods, including `extra_body_parameters`:
+
+```rb
+options = {
+  formality: 'more',
+  extra_body_parameters: { example_param: 'true' }
+}
+doc_handle = DeepL.document.upload('/path/to/spanish_document.pdf', 'ES', 'EN', nil, options)
+```
+
+The `extra_body_parameters` option allows you to pass arbitrary parameters in the request body. This can be used to access beta features by adding new parameters, or to override built-in parameters (such as `target_lang`, `source_lang`, etc.) for testing purposes.
+
 ### Handle exceptions
 
 You can capture and process exceptions that may be raised during API calls. These are all the possible exceptions:
@@ -389,6 +433,30 @@ end
 
 This information is passed along when the library makes calls to the DeepL API. Both name and version are required. Please note that setting the `User-Agent` header via `deepl.configure` will override this setting, if you need to use this, please manually identify your Application in the `User-Agent` header.
 
+## Options Constants
+
+The available values for various possible options are provided under the `DeepL::Constants` namespace. The currently available options are
+
+`TagHandling`
+`SplitSentences`
+`ModelType`
+`Formality`
+`WritingStyle`
+`Tone`
+
+To view all the possible options for a given constant, call `options`:
+
+```rb
+all_available_tones = DeepL::Constants::Tones.options
+```
+
+To check if a given string is a possible option for a given constant, call `valid?`:
+
+```rb
+DeepL::Constants::Tones.valid?('friendly') # true
+DeepL::Constants::Tones.valid?('rude') # false
+```
+
 ## Integrations
 
 ### Ruby on Rails

data/Rakefile

@@ -33,6 +33,7 @@ Juwelier::Tasks.new do |gem|
   }
   gem.files.exclude '.github'
   gem.files.exclude '.circleci'
+  gem.files.exclude 'catalog-info.yaml'
 end
 
 Juwelier::RubygemsDotOrgTasks.new

data/VERSION

@@ -1 +1 @@
-3.1.0
+3.3.0

data/deepl-rb.gemspec

@@ -2,17 +2,17 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Juwelier::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: deepl-rb 3.1.0 ruby lib
+# stub: deepl-rb 3.3.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "deepl-rb".freeze
-  s.version = "3.1.0"
+  s.version = "3.3.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.metadata = { "bug_tracker_uri" => "https://github.com/DeepLcom/deepl-rb/issues", "changelog_uri" => "https://github.com/DeepLcom/deepl-rb/blob/main/CHANGELOG.md", "documentation_uri" => "https://github.com/DeepLcom/deepl-rb/blob/main/README.md", "homepage_uri" => "https://github.com/DeepLcom/deepl-rb" } if s.respond_to? :metadata=
   s.require_paths = ["lib".freeze]
   s.authors = ["DeepL SE".freeze]
-  s.date = "2024-11-15"
+  s.date = "2025-11-04"
   s.description = "Official Ruby library for the DeepL language translation API (v2). For more information, check this: https://www.deepl.com/docs/api-reference.html".freeze
   s.email = "open-source@deepl.com".freeze
   s.extra_rdoc_files = [
@@ -39,6 +39,13 @@ Gem::Specification.new do |s|
     "lib/deepl.rb",
     "lib/deepl/api.rb",
     "lib/deepl/configuration.rb",
+    "lib/deepl/constants/base_constant.rb",
+    "lib/deepl/constants/formality.rb",
+    "lib/deepl/constants/model_type.rb",
+    "lib/deepl/constants/split_sentences.rb",
+    "lib/deepl/constants/tag_handling.rb",
+    "lib/deepl/constants/tone.rb",
+    "lib/deepl/constants/writing_style.rb",
     "lib/deepl/document_api.rb",
     "lib/deepl/exceptions/authorization_failed.rb",
     "lib/deepl/exceptions/bad_request.rb",
@@ -63,6 +70,7 @@ Gem::Specification.new do |s|
     "lib/deepl/requests/glossary/language_pairs.rb",
     "lib/deepl/requests/glossary/list.rb",
     "lib/deepl/requests/languages.rb",
+    "lib/deepl/requests/rephrase.rb",
     "lib/deepl/requests/translate.rb",
     "lib/deepl/requests/usage.rb",
     "lib/deepl/resources/base.rb",
@@ -80,14 +88,17 @@ Gem::Specification.new do |s|
     "spec/api/api_spec.rb",
     "spec/api/configuration_spec.rb",
     "spec/api/deepl_spec.rb",
+    "spec/constants/constants_spec.rb",
     "spec/fixtures/vcr_cassettes/deepl_document.yml",
     "spec/fixtures/vcr_cassettes/deepl_document_download.yml",
     "spec/fixtures/vcr_cassettes/deepl_glossaries.yml",
     "spec/fixtures/vcr_cassettes/deepl_languages.yml",
+    "spec/fixtures/vcr_cassettes/deepl_rephrase.yml",
     "spec/fixtures/vcr_cassettes/deepl_translate.yml",
     "spec/fixtures/vcr_cassettes/deepl_usage.yml",
     "spec/fixtures/vcr_cassettes/glossaries.yml",
     "spec/fixtures/vcr_cassettes/languages.yml",
+    "spec/fixtures/vcr_cassettes/rephrase_texts.yml",
     "spec/fixtures/vcr_cassettes/translate_texts.yml",
     "spec/fixtures/vcr_cassettes/usage.yml",
     "spec/integration_tests/document_api_spec.rb",
@@ -99,6 +110,7 @@ Gem::Specification.new do |s|
     "spec/requests/glossary/language_pairs_spec.rb",
     "spec/requests/glossary/list_spec.rb",
     "spec/requests/languages_spec.rb",
+    "spec/requests/rephrase_spec.rb",
     "spec/requests/translate_spec.rb",
     "spec/requests/usage_spec.rb",
     "spec/resources/glossary_spec.rb",

data/lib/deepl/constants/base_constant.rb

@@ -0,0 +1,18 @@
+# Copyright 2025 DeepL SE (https://www.deepl.com)
+# Use of this source code is governed by an MIT
+# license that can be found in the LICENSE.md file.
+# frozen_string_literal: true
+
+module DeepL
+  module Constants
+    class BaseConstant
+      def self.options
+        constants.map { |const| const_get(const) }
+      end
+
+      def self.valid?(value)
+        options.include?(value)
+      end
+    end
+  end
+end

data/lib/deepl/constants/formality.rb

@@ -0,0 +1,16 @@
+# Copyright 2025 DeepL SE (https://www.deepl.com)
+# Use of this source code is governed by an MIT
+# license that can be found in the LICENSE.md file.
+# frozen_string_literal: true
+
+module DeepL
+  module Constants
+    class Formality < BaseConstant
+      DEFAULT = 'default'
+      MORE = 'more'
+      LESS = 'less'
+      PREFER_MORE = 'prefer_more'
+      PREFER_LESS = 'prefer_less'
+    end
+  end
+end

data/lib/deepl/constants/model_type.rb

@@ -0,0 +1,14 @@
+# Copyright 2025 DeepL SE (https://www.deepl.com)
+# Use of this source code is governed by an MIT
+# license that can be found in the LICENSE.md file.
+# frozen_string_literal: true
+
+module DeepL
+  module Constants
+    class ModelType < BaseConstant
+      QUALITY_OPTIMIZED = 'quality_optimized'
+      PREFER_QUALITY_OPTIMIZED = 'prefer_quality_optimized'
+      LATENCY_OPTIMIZED = 'latency_optimized'
+    end
+  end
+end

data/lib/deepl/constants/split_sentences.rb

@@ -0,0 +1,14 @@
+# Copyright 2025 DeepL SE (https://www.deepl.com)
+# Use of this source code is governed by an MIT
+# license that can be found in the LICENSE.md file.
+# frozen_string_literal: true
+
+module DeepL
+  module Constants
+    class SplitSentences < BaseConstant
+      NO_SPLITTING = '0'
+      SPLIT_ON_PUNCTUATION_AND_NEWLINES = '1'
+      SPLIT_ON_PUNCTUATION_ONLY = 'nonewlines'
+    end
+  end
+end

data/lib/deepl/constants/tag_handling.rb

@@ -0,0 +1,13 @@
+# Copyright 2025 DeepL SE (https://www.deepl.com)
+# Use of this source code is governed by an MIT
+# license that can be found in the LICENSE.md file.
+# frozen_string_literal: true
+
+module DeepL
+  module Constants
+    class TagHandling < BaseConstant
+      XML = 'xml'
+      HTML = 'html'
+    end
+  end
+end

data/lib/deepl/constants/tone.rb

@@ -0,0 +1,20 @@
+# Copyright 2025 DeepL SE (https://www.deepl.com)
+# Use of this source code is governed by an MIT
+# license that can be found in the LICENSE.md file.
+# frozen_string_literal: true
+
+module DeepL
+  module Constants
+    class Tone < BaseConstant
+      DEFAULT = 'default'
+      ENTHUSIASTIC = 'enthusiastic'
+      FRIENDLY = 'friendly'
+      CONFIDENT = 'confident'
+      DIPLOMATIC = 'diplomatic'
+      PREFER_ENTHUSIASTIC = 'prefer_enthusiastic'
+      PREFER_FRIENDLY = 'prefer_friendly'
+      PREFER_CONFIDENT = 'prefer_confident'
+      PREFER_DIPLOMATIC = 'prefer_diplomatic'
+    end
+  end
+end

data/lib/deepl/constants/writing_style.rb

@@ -0,0 +1,20 @@
+# Copyright 2025 DeepL SE (https://www.deepl.com)
+# Use of this source code is governed by an MIT
+# license that can be found in the LICENSE.md file.
+# frozen_string_literal: true
+
+module DeepL
+  module Constants
+    class WritingStyle < BaseConstant
+      DEFAULT = 'default'
+      SIMPLE = 'simple'
+      BUSINESS = 'business'
+      ACADEMIC = 'academic'
+      CASUAL = 'casual'
+      PREFER_SIMPLE = 'prefer_simple'
+      PREFER_BUSINESS = 'prefer_business'
+      PREFER_ACADEMIC = 'prefer_academic'
+      PREFER_CASUAL = 'prefer_casual'
+    end
+  end
+end

data/lib/deepl/exceptions/authorization_failed.rb

@@ -6,7 +6,7 @@
 module DeepL
   module Exceptions
     class AuthorizationFailed < RequestError
-      def message
+      def to_s
         'Authorization failed. Please supply a valid auth_key parameter.'
       end
     end

data/lib/deepl/exceptions/bad_request.rb

@@ -6,7 +6,7 @@
 module DeepL
   module Exceptions
     class BadRequest < RequestError
-      def message
+      def to_s
         JSON.parse(response.body)['message']
       rescue JSON::ParserError
         response.body

data/lib/deepl/exceptions/limit_exceeded.rb

@@ -6,7 +6,7 @@
 module DeepL
   module Exceptions
     class LimitExceeded < RequestError
-      def message
+      def to_s
         'Limit exceeded. Please wait and send your request once again.'
       end
 

data/lib/deepl/exceptions/not_found.rb

@@ -6,7 +6,7 @@
 module DeepL
   module Exceptions
     class NotFound < RequestError
-      def message
+      def to_s
         JSON.parse(response.body)['message']
       rescue JSON::ParserError
         response.body

data/lib/deepl/exceptions/quota_exceeded.rb

@@ -6,7 +6,7 @@
 module DeepL
   module Exceptions
     class QuotaExceeded < RequestError
-      def message
+      def to_s
         'Quota exceeded. The character limit has been reached.'
       end
     end

data/lib/deepl/exceptions/request_entity_too_large.rb

@@ -6,7 +6,7 @@
 module DeepL
   module Exceptions
     class RequestEntityTooLarge < RequestError
-      def message
+      def to_s
         'The request size has reached the supported limit. ' \
           "Make sure that you're not sending more than 50 text parts."
       end

data/lib/deepl/exceptions/request_error.rb

@@ -13,7 +13,7 @@ module DeepL
         @response = response
       end
 
-      def message
+      def to_s
         'Unknown error.'
       end
     end

data/lib/deepl/exceptions/server_error.rb

@@ -6,7 +6,7 @@
 module DeepL
   module Exceptions
     class ServerError < RequestError
-      def message
+      def to_s
         'An internal server error occured. Try again after waiting a short period.'
       end
 

data/lib/deepl/requests/base.rb

@@ -46,6 +46,40 @@ module DeepL
         end
       end
 
+      # Returns options excluding extra_body_parameters
+      # extra_body_parameters are applied separately via apply_extra_body_parameters_* methods
+      def options_without_extra_params
+        options.reject do |k, _|
+          k.to_s == 'extra_body_parameters' || k.to_sym == :extra_body_parameters
+        end
+      end
+
+      # Apply extra body parameters to a hash payload (for JSON/form-encoded requests)
+      # Extra parameters will override existing keys
+      def apply_extra_body_parameters_to_json(payload)
+        return unless option?(:extra_body_parameters)
+
+        extra_params = option(:extra_body_parameters)
+        extra_params.each do |key, value|
+          payload[key] = value.to_s
+        end
+      end
+
+      # Apply extra body parameters to multipart form data array
+      # Extra parameters will override existing keys
+      def apply_extra_body_parameters_to_form(form_data)
+        return unless option?(:extra_body_parameters)
+
+        extra_params = option(:extra_body_parameters)
+        extra_params.each do |key, value|
+          key_str = key.to_s
+          # Remove existing key if present to allow override.
+          # Required for form data as it would be duplicated otherwise
+          form_data.reject! { |field| field[0].to_s == key_str }
+          form_data.push([key_str, value.to_s])
+        end
+      end
+
       # Files to reset: list of file objects to rewind when retrying the request
       def execute_request_with_retries(req, files_to_reset = []) # rubocop:disable all
         api.configuration.logger&.info("Request to the DeepL API: #{self}")
@@ -88,17 +122,16 @@ module DeepL
       end
 
       def post_request(payload)
+        apply_extra_body_parameters_to_json(payload)
         http_headers = add_json_content_type(headers)
         post_req = Net::HTTP::Post.new(uri.path, http_headers)
-        post_req.body = payload.merge(options).to_json
+        post_req.body = payload.merge(options_without_extra_params).to_json
         post_req
       end
 
       def post_request_with_file(form_data)
         http_headers = add_multipart_form_content_type(headers)
         post_req = Net::HTTP::Post.new(uri.request_uri, http_headers)
-        # options are passed in `form_data`
-        form_data += options.map { |key, value| [key.to_s, value.to_s] }
         post_req.set_form(form_data, 'multipart/form-data')
         post_req
       end
@@ -106,14 +139,14 @@ module DeepL
       def get_request # rubocop:disable Naming/AccessorMethodName
         http_headers = add_json_content_type(headers)
         get_req = Net::HTTP::Get.new(uri.path, http_headers)
-        get_req.body = options.to_json
+        get_req.body = options_without_extra_params.to_json
         get_req
       end
 
       def delete_request
         http_headers = add_json_content_type(headers)
         del_req = Net::HTTP::Delete.new(uri.path, http_headers)
-        del_req.body = options.to_json
+        del_req.body = options_without_extra_params.to_json
         del_req
       end