invantive documentation
Invantive Support ForumsAanmelden / Inschrijven

TranslationsByText: DeepL Translations

read only REST

  • Catalogus: DeepL
  • Schema: Translate
  • Label: Translations

Kan alleen gegevens ophalen.

Samenvatting

The translation of one text. Billed per character on every execution.

API-bron

  • Eindpunt: /v2/translate

Prestatiekenmerken

Characteristic Value
Gemiddelde toegangsvertraging (ms) 31

Parameters

Name Datatype Required Default Documentation
context varchar2 Text that influences the translation without being translated itself.Not billed.
custom_instructions varchar2 JSON array of up to 10 instructions of at most 300 characters.
formality varchar2 default, more, less, prefer_more or prefer_less.
glossary_id varchar2 The glossary to apply; requires source_lang.
glossary_ids varchar2 Comma-separated list of up to 5 glossaries; excludes glossary_id.
ignore_tags varchar2 Comma-separated XML tags whose content is not translated.
model_type varchar2 quality_optimized, prefer_quality_optimized or latency_optimized.
non_splitting_tags varchar2 Comma-separated XML tags which never split sentences.
outline_detection boolean False disables the automatic detection of the XML structure.
preserve_formatting boolean Whether DeepL keeps the formatting even where it would correct it.
reporting_tag varchar2 Custom reporting tag of the request; overrides the connection attribute reporting-tag.
source_lang varchar2 Language of the text.When absent, DeepL detects it; a glossary requires it.
split_sentences varchar2 0 (no splitting), 1 (default) or nonewlines.
splitting_tags varchar2 Comma-separated XML tags which always split sentences.
style_id varchar2 The style rule list to apply.
tag_handling varchar2 xml or html.
tag_handling_version varchar2 v1 or v2.
target_lang varchar2 The language to translate into, such as NL, DE or EN-GB.
text varchar2 The text to translate.
translation_memory_id varchar2 The translation memory to apply.
translation_memory_threshold int32 Minimum matching percentage of a translation memory segment; below 50 is 50.

Tabelkolommen

De kolommen van de tabel TranslationsByText worden hieronder weergegeven. Elke kolom heeft een SQL-gegevenstype. Voor elke vereiste kolom moet bij het invoegen en bijwerken steeds een nieuwe, niet-lege waarde worden opgegeven.

Name Datatype Label Required Marks Documentation
billed_characters int32 itgen_dpl_billed_characters filters on the platform, writable The characters DeepL billed for the text in this execution; 0 when the translation came from the cache.
detected_source_language varchar2 itgen_dpl_detected_source_language filters on the platform, writable The source language, as given or as detected.
model_type_used varchar2 itgen_dpl_model_type_used filters on the platform, writable The model used; only when a model type was requested.
tag_handling_version varchar2 itgen_dpl_tag_handling_version filters on the platform, writable The tag handling algorithm used; only with tag handling.
translated_text varchar2 itgen_dpl_translated_text filters on the platform, writable The translated text.

Voorbeeldqueries

select trn.translated_text
,      trn.billed_characters
from   DeepL.Translate.TranslationsByText('The licence key is invalid.', 'NL', source_lang => 'EN') trn