DeepL MT Connector: Difference between revisions

From Okapi Framework
Jump to navigation Jump to search
No edit summary
m (change link to API doc)
 
(2 intermediate revisions by one other user not shown)
Line 3: Line 3:
==Overview==
==Overview==


Starting in M36, DeepL MT service API (documented at https://www.deepl.com/api.html) can be access with this connector.
Starting in M36, DeepL MT service API (documented at https://www.deepl.com/en/docs-api/) can be access with this connector.


==Using the Connector==
==Using the Connector==
Line 18: Line 18:


<cite>Split sentences</cite> (internal name: <tt>splitSentences</tt>) &mdash; True to segment by sentence during the MT process (this provides less context).
<cite>Split sentences</cite> (internal name: <tt>splitSentences</tt>) &mdash; True to segment by sentence during the MT process (this provides less context).
<cite>Preserve some formatting aspects</cite> (internal name: <tt>preserveFormatting</tt>) &mdash; True to try to preserve as much as possible upper/lowe cases, trailing punctuation, etc.


==Limitations==
==Limitations==


* There are limitations in the size of the query and the number of segments that can be submitted at once. The connector tries to handle those restriction. See the DeepL API for more information.
* There are limitations in the size of the query and the number of segments that can be submitted at once. The connector tries to handle those restriction. See the DeepL API for more information.
* The <tt>split_sentences</tt> and <tt>preserve_formatting</tt> options are not supported yet.


[[Category:Connectors]]
[[Category:Connectors]]

Latest revision as of 03:37, 12 July 2021

Overview

Starting in M36, DeepL MT service API (documented at https://www.deepl.com/en/docs-api/) can be access with this connector.

Using the Connector

The connector can be accessed programmatically.

Parameters

DeepL authentication key (internal name: authKey) — the API key to allow access to the API.

Get plain-text translation (internal name: plainText) — Option to get plain-text MT candidates from DeepL. When this option is set the segments submitted to the DeepL API are stripped of inline codes. When this option is not set, the inline codes are converted to XML generic tags and submitted as such to DeepL, and then converted back to the original inline codes.

Split sentences (internal name: splitSentences) — True to segment by sentence during the MT process (this provides less context).

Preserve some formatting aspects (internal name: preserveFormatting) — True to try to preserve as much as possible upper/lowe cases, trailing punctuation, etc.

Limitations

  • There are limitations in the size of the query and the number of segments that can be submitted at once. The connector tries to handle those restriction. See the DeepL API for more information.