# A text translation service.

A text translation service supporting multiple translation engine.

Endpoint: POST /text/translate
Version: 2025-08-18T18:01:56Z
Security: api_key

## Request fields (application/json):

  - `text` (string, required)
    The text content with UTF-8 text representation

  - `target` (string, required)
    Two letter language code for the target language to translate the source text into.

  - `source` (string)
    Two letter language code for the source language. If left blank, the model will try to infer the language.

  - `ishtml` (boolean)
    A boolean flag that should be set to true if text is in HTML markup.

  - `engine` (string)
    The generative model to use.
    Enum: "genai", "deepl"

  - `ctxgenai` (object)
    Configuration for the genai model.

  - `ctxgenai.random` (number)
    Controls the amount of randomness in the generated text. Lowering this will result in the output to be more deterministic.

  - `ctxgenai.model` (string)
    The generative model to use.
    Enum: "gpt4-o", "gpt4-o-mini", "gpt4", "gpt4-t", "o1", "o1-mini"

  - `ctxdeepl` (object)
    Configuration for the DeepL model.

  - `ctxdeepl.glossaryId` (string)
    The ID of the glossary to be applied.

  - `ctxdeepl.formalityCode` (string)
    The formality of the translation.
    Enum: "default", "more", "less", "prefer_more", "prefer_less"

  - `ctxdeepl.version` (string)
    The version of the DeepL model to use.
    Enum: "V1", "V2"