Enable support for Beta languages

Enable support for Beta languages.

To activate support for languages in Beta, your API request needs to specify the enable_beta_languages option.

Note: this option should be true for JSON-encoded requests, and 1 for URL-encoded requests.

Here are some examples how to do this in plain HTTP, as a cURL command, and using our client libraries.

HTTP Request

Example request

POST /v2/translate HTTP/2
Host: api.deepl.com
Authorization: DeepL-Auth-Key [yourAuthKey] 
User-Agent: YourApp/1.2.3
Content-Length: 45
Content-Type: application/json

{
  "text": ["Hello, world!"],
  "target_lang":"ace",
  "enable_beta_languages": true
  }

cURL

Example request -- JSON-encoded

curl -X POST 'https://api.deepl.com/v2/translate' \
--header 'Authorization: DeepL-Auth-Key [yourAuthKey]' \
--header 'Content-Type: application/json' \
--data '{
  "text": [
    "Hello, world!"
  ],
  "target_lang": "ace",
  "enable_beta_languages": true
}'

Example request -- URL-encoded

curl -X POST 'https://api.deepl.com/v2/translate' \
--header 'Authorization: DeepL-Auth-Key [yourAuthKey]' \
--url-encoded "text=Hello, world!" \
--url-encoded "target_lang=ace" \
--url-encoded "enable_beta_languages=1"

Python

Minimum client library version: 1.24.0

result = deepl_client.translate_text(
    "Hello, world!",
    target_lang="ace",
    extra_body_parameters={
        "enable_beta_languages": True,
    })

Node.JS

Minimum client library version: 1.21.0

const result = await deeplClient.translateText(
    'Hello, world!',
    null,
    'ace' as deepl.TargetLanguageCode, // type-override for beta language.
    {
        extraRequestParameters:
            {
                'enable_beta_languages': '1'
            }
    });

PHP

Minimum client library version: 1.13.0

$result = $deeplClient->translateText(
    'Hello, world!',
    null,
    'ace',
    [TranslateTextOptions::EXTRA_BODY_PARAMETERS => [
        'enable_beta_languages' => '1'
    ]]);

C#

Minimum client library version: 1.16.0

var translatedText = await client.TranslateTextAsync(
    "Hello, world!",
    null,
    "ace",
    new TextTranslateOptions { ExtraBodyParameters = new Dictionary<string, string> { { "enable_beta_languages", "1" } } });

Java

Minimum client library version: 1.11.0

TextTranslationOptions textTranslationOptions = new TextTranslationOptions();
textTranslationOptions.setExtraBodyParameters(
    Map.of("enable_beta_languages", "1");
);
TextResult result = deepLClient.translateText("Hello, world!", null, "ace",
    textTranslationOptions);

Ruby

Minimum client library version: 3.3.0

translation = DeepL.translate 'Hello, world!', nil, 'ace',
                              extra_body_parameters: { enable_beta_languages: true }

All examples should return “Hello, world!” translated into Acehnese (ace), one of the new languages: “Hai, donya!”.

Example response

{
  "translations": [
    {
      "detected_source_language": "EN",
      "text": "Hai, donya!"
    }
  ]
}