---
title: "TranslationsByTextList (DeepL)"
description: "Text List Translations"
language: es
source_language: en
translation_state: pending
canonical: https://documentation.invantive.eu/es/datamodels/deepl/DeepL.Translate.TranslationsByTextList
original: https://documentation.invantive.eu/en/datamodels/deepl/DeepL.Translate.TranslationsByTextList
updated: 2026-11-16T20:46:25Z
license: https://documentation.invantive.eu/es/
---

# TranslationsByTextList: DeepL Text List Translations

`read only` `REST`

- Catálogo: `DeepL`
- Esquema: `Translate`
- Label: Text List Translations

Solo puede recuperar datos.

## Resumen

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

## Fuente de la API

- Punto final: `/v2/translate`

## Características de rendimiento

| Characteristic | Value |
|---|---:|
| Latencia media de acceso (ms) | 45 |

## Parámetros

| Name | Tipo de Datos | 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` | [x] |  | 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. |

## Columnas de la Tabla

A continuación se muestran las columnas de la tabla `TranslationsByTextList`. Cada columna tiene un tipo de datos SQL. Se debe proporcionar un nuevo valor no nulo para cada columna requerida en todo momento durante la inserción y la actualización.

| Name | Tipo de Datos | 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 | [x] | filters on the platform, writable | The position of the element in the text list, starting at 1. |
| `request_ordinal` | `int32` | itgen_dpl_request_ordinal | [x] | 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 | [x] | 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. |
