LIlilt
Translate

Translate a segment

Changed on

Translate a source string.

Setting the rich parameter to true will change the response format to include additional information about each translation including a model score, word alignments, and formatting information. The rich format can be seen in the example response on this page.

By default, this endpoint also returns translation memory (TM) fuzzy matches, along with associated scores. Fuzzy matches always appear ahead of machine translation output in the response.

The maximum source length is 50,000 characters. When a prefix is supplied (prefix-based translation), the maximum source length is 5,000 characters.

Word-alignment and formatting fields (targetWords, targetDelimiters, and provenance) are returned only for prefix or source_hash requests. Plain (non-prefixed) translations return target and targetWithTags only. The source-side fields tokenizedSource and sourceDelimiters are no longer returned.

Usage charges apply to this endpoint for production API keys.

post/v2/translate

Request

  • Base URL
    https://api.lilt.com
  • URL
    https://api.lilt.com/v2/translate
  • Auth
    HTTP basic

Request body

sourcestring

A unique Segment identifier.

memory_idinteger required

A unique Memory identifier.

source_hashinteger

A source hash code.

ninteger

Return top n translations (deprecated).

prefixstring

A target prefix

richboolean

Returns rich translation information (e.g., with word alignments).

tm_matchesboolean

Include translation memory fuzzy matches.

project_tagsboolean

Project tags. Projects tags in source to target if set to true.

containsICUDataboolean

Contains ICU data. If true then tags in the source following the ICU standard will be parsed and retained.

Response

A TranslationList object.

untokenizedSourcestring

The untokenized source segment. Punctuation has not been separated from words.

tokenizedSourcestring

No longer returned by /2/translate. The tokenized source segment. Punctuation has been separated from words.

sourceDelimitersstring[]

No longer returned by /2/translate. A format string that indicates, for each word, if the word should be preceded by a space.

Example response

{
  "untokenizedSource": "Authentication not required.",
  "tokenizedSource": "Authentication not required .",
  "sourceDelimiters": [
    "",
    " ",
    " ",
    "",
    ""
  ]
}

Changes