invantive documentation
Invantive Support ForumsAanmelden / Inschrijven

TranslationsByTextList: DeepL Text List Translations

read only REST

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

Kan alleen gegevens ophalen.

Samenvatting

The translation of a list of texts, in as few requests as the request size of DeepL allows. Billed per character on every execution.

API-bron

  • Eindpunt: /v2/translate

Prestatiekenmerken

Characteristic Value
Gemiddelde toegangsvertraging (ms) 45

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, for every element that names none of its own.
text_list clob JSON array of texts, or of objects with text and optionally key, target_lang, source_lang, glossary_id and context.
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 TranslationsByTextList 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.
key varchar2 itgen_dpl_key filters on the platform, writable The key of the element in the text list, returned unchanged.
model_type_used varchar2 itgen_dpl_model_type_used filters on the platform, writable The model used; only when a model type was requested.
ordinal int32 itgen_dpl_ordinal filters on the platform, writable The position of the element in the text list, starting at 1.
request_ordinal int32 itgen_dpl_request_ordinal filters on the platform, writable The number of the request the element was sent in, starting at 1.
source_lang varchar2 itgen_dpl_source_lang filters on the platform, writable The source language of the element as requested.
tag_handling_version varchar2 itgen_dpl_tag_handling_version filters on the platform, writable The tag handling algorithm used; only with tag handling.
target_lang varchar2 itgen_dpl_target_lang filters on the platform, writable The target language of the element.
text varchar2 itgen_dpl_text filters on the platform, writable The text as sent.
translated_text varchar2 itgen_dpl_translated_text filters on the platform, writable The translated text.