GETTING STARTED
API REFERENCE
Text-Based Translation
Supported Languages
The Bering API supports text translations from and to the following languages:
Language
API Argument
English
eng
Korean
kor
Japanese
jap
Chinese (Simplified)
cmn
Chinese (Traditional)
zho
French
fra
German
deu
Spanish
spa
Indonesian
ind
HTTP Request
The total request body size for text translation requests must not exceed 1MB.
We recommend splitting up your text if you want to translate in excess of this limit.
Host: https://api-v2.beringlab.com
POST: /task-management/api/v1/external/mt/text-api-jobs
Request Body Description
Body parameter
Description
source_language (required)
string (enum) target_language (required)
string (enum) domain (required)
string (enum) source_content (required)
Text to be translated. Defaults to interpreting argument as plain text. For XML, set the kind parameter to ‘xml_docx’.
Type: string (UTF-8 encoded)
subscription_id (required)
Found on the Settings page under ‘API plan Subscription ID’. See Access and Authentication for more details.
string api_key (required)
Your API Key generated in Access and Authentication.
string kind (optional)
Used when passing XML to the source_content parameter.
string Response Body Description
Body parameter
Description
job_id
ID used to get the translated text.
string status_code
Status of the API request
Type: integer
POST: /task-management/api/v1/external/mt/text-api-jobs/[ job_id ]
Request Body Description
Body parameter
Description
subscription_id (required)
Found on the Settings page under ‘API plan Subscription ID’. See Access and Authentication for more details.
string api_key (required)
Your API Key generated in Access and Authentication.
string Response Body Description
Body parameter
Description
text
The translated text.
string status_code
Status of the API request
Type: integer