Translate a segment

curl --request POST \
  --url 'https://api.lilt.com/v2/translate?key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "memory_id": 123,
  "source": "<string>",
  "source_hash": 123,
  "n": 123,
  "prefix": "<string>",
  "rich": false,
  "tm_matches": true,
  "project_tags": false,
  "containsICUData": false
}
'

{
  "untokenizedSource": "Authentication not required.",
  "tokenizedSource": "Authentication not required .",
  "sourceDelimiters": [
    "",
    " ",
    " ",
    "",
    ""
  ],
  "translation": [
    [
      {
        "score": 3.4936864e-8,
        "align": "0-0 1-1 2-2 3-3",
        "targetDelimiters": [
          "",
          " ",
          " ",
          "",
          ""
        ],
        "targetWords": [
          "Authentifizierung",
          "nicht",
          "erforderlich",
          "."
        ],
        "target": "Authentifizierung nicht erforderlich .",
        "targetWithTags": "Authentifizierung nicht erforderlich.",
        "isTMMatch": false,
        "provenance": "0 0 0 0"
      }
    ]
  ]
}

Translate

Translate a segment

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 5,000 characters.

Usage charges apply to this endpoint for production API keys.

POST

translate

Translate a segment

curl --request POST \
  --url 'https://api.lilt.com/v2/translate?key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "memory_id": 123,
  "source": "<string>",
  "source_hash": 123,
  "n": 123,
  "prefix": "<string>",
  "rich": false,
  "tm_matches": true,
  "project_tags": false,
  "containsICUData": false
}
'

{
  "untokenizedSource": "Authentication not required.",
  "tokenizedSource": "Authentication not required .",
  "sourceDelimiters": [
    "",
    " ",
    " ",
    "",
    ""
  ],
  "translation": [
    [
      {
        "score": 3.4936864e-8,
        "align": "0-0 1-1 2-2 3-3",
        "targetDelimiters": [
          "",
          " ",
          " ",
          "",
          ""
        ],
        "targetWords": [
          "Authentifizierung",
          "nicht",
          "erforderlich",
          "."
        ],
        "target": "Authentifizierung nicht erforderlich .",
        "targetWithTags": "Authentifizierung nicht erforderlich.",
        "isTMMatch": false,
        "provenance": "0 0 0 0"
      }
    ]
  ]
}

Authorizations

key

string

query

required

Body

application/json

memory_id

integer

required

A unique Memory identifier.

source

string

A unique Segment identifier.

source_hash

integer

A source hash code.

integer

Return top n translations (deprecated).

prefix

string

A target prefix

rich

boolean

default:false

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

tm_matches

boolean

default:true

Include translation memory fuzzy matches.

project_tags

boolean

default:false

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

containsICUData

boolean

default:false

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

Response

A TranslationList object.

An ranked list of translations and associated metadata.

untokenizedSource

string

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

Example:

"Authentication not required."

tokenizedSource

string

The tokenized source segment. Punctuation has been separated from words.

Example:

"Authentication not required ."

sourceDelimiters

string[]

A format string that indicates, for each word, if the word should be preceded by a space.

Example:

["", " ", " ", "", ""]

translation

object[]

A list of Translation objects.

Show child attributes

translation.target

string

The target string.

translation.targetWithTags

string

The target string with source tags projected into the target.

translation.align

string

"MT only: A whitespace delimited list of source-target alignment indices."

translation.provenance

string

Positive values indicate that the word is from the Memory, with contiguous identical entries (e.g., 2 2) indicating phrase matches. Negative contiguous values indicate entries from the Lexicon. 0 indicates a word from the background data.

translation.score

number

The score of the translation.

translation.isTMMatch

boolean

TM only: If true, indicates an exact translation memory match.

translation.targetDelimiters

string[]

A format string that indicates, for each word, if the word should be preceded by a space.

translation.targetWords

string[]

The target string can be constructed by suffixing each targetDelimiters entry with its corresponding word in targetWords and concatenating the constructed array. Please note that the targetDelimiters array has one more entry than targetWords array which is why the last entry in the array will be the last value of targetDelimiters.

Tag a Segment Monitor file translation

⌘I

Docs

API Reference

Translate a segment

Authorizations

Body

Response