# Translate text

This method translates the input text.
The request body should include the following elements:
* `from` (string) - A standard IETF tag for the source language. Use `*` or a vertical bar-delimited set of language codes to invoke autodetect.
* `to` (string) - A standard IETF tag for the target language. If the source and target languages are the same, paraphrasing will be applied.
* `content` (string) - The text content to translate.
* `settings` (object) - Additional translation settings.

More information: [Tisane API Configuration And Customization Guide](./tisane-api-configuration.md)
The response is the transformed text.

Endpoint: POST /transform
Version: 4.8.0.0
Security: Tisane-API-Key

## Security:

  - `Tisane-API-Key` (unknown)
    apiKey in header Ocp-Apim-Subscription-Key

## Header parameters:

  - `Content-Type` (string)

## Request fields (application/json):

  - `from` (string)

  - `to` (string)

  - `content` (string)

  - `settings` (object)

  - `settings.snippets` (boolean)
    When set to `true`, relevant fragments are included in `abuse`, `sentiment_expressions`, and `entities_summary` sections.

  - `settings.abuse` (boolean)
    Whether to output `abuse`. Default: `true`

  - `settings.sentiment` (boolean)
    Whether to output sentiment. Default: `true`

  - `settings.topics` (boolean)
    Whether to output topics. Default: `true`

  - `settings.entities` (boolean)
    Whether to output entity information. Default: `true`

  - `settings.relations` (boolean)
    When `true`, relations between the entities are provided.

  - `settings.disable_spellcheck` (boolean)
    When set to `true`, spellchecking is not used. Default: `false` (the spellchecking is on by default)

  - `settings.words` (boolean)
    When set to `true`, individual lexical chunks are provided.

  - `settings.state` (boolean)
    When set to `true`, the long-term memory contents are returned.

  - `settings.memory` (object)

  - `settings.memory.flags` (array)

  - `settings.memory.flags.type` (string)
    Feature type. If unspecified: Grammar
    Enum: "Grammar", "Semantics", "Style"

  - `settings.memory.flags.index` (integer, required)
    Feature index (within its type)

  - `settings.memory.flags.value` (string, required)
    Feature value ID

  - `settings.memory.antecedents` (array)
    Previously mentioned elements to be used for coreference resolution.

  - `settings.memory.antecedents.family` (integer)
    The family ID of the antecedent.

  - `settings.memory.assign` (array)
    Conditional assignments to be executed when parsing.

  - `settings.memory.assign.if` (object, required)
    Conditions to match (all conditions must match).

  - `settings.memory.assign.if.family` (integer)
    A family ID of the target lexeme.

  - `settings.memory.assign.if.hypernym` (integer)
    A family ID of a hypernym of the target lexeme.

  - `settings.memory.assign.if.regex` (string)
    A regular expression to match.

  - `settings.memory.assign.then` (object, required)
    Attribute values to assign.

  - `settings.memory.assign.then.family` (integer)
    A family ID to assign.

  - `settings.memory.assign.then.hypernym` (integer)
    A family ID of a hypernym to assign.

  - `settings.memory.assign.then.attribution` (boolean)
    Marks the target as attribution.

## Request examples:

  - `Translate a Japanese sentence` (unknown)

  - `Auto-detect language and translate Chinese name to English` (unknown)

  - `Translate from English to Russian` (unknown)

  - `Translate Russian drug addict jargon to English` (unknown)

  - `Translate from Hebrew to Russian preserving gender` (unknown)

## Response 200:

  - `200` (unknown)
    Successful translation response

## Response 400:

  - `400` (unknown)
    Bad request - invalid JSON or language code.

## Response 401:

  - `401` (unknown)
    Unauthorized - invalid API key or quota exceeded.

## Response 500:

  - `500` (unknown)
    Internal server error

## Response 200 examples:

  - `Translate a Japanese sentence` (unknown)

  - `Auto-detect language and translate Chinese name to English` (unknown)

  - `Translate from English to Russian` (unknown)

  - `Translate Russian drug addict jargon to English` (unknown)

  - `Translate from Hebrew to Russian preserving gender` (unknown)

