GETTING STARTED
API REFERENCE
Text-Based Translation
Supported Languages
The Bering API supports text translations using 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
Arabic
ara
The table below shows the supported translation language pairs:
Translate From
Translate To
eng
kor, jap, cmn, zho, fra, deu, spa, ind
kor
eng
jap
eng
cmn
eng
zho
eng
fra
eng
deu
eng
spa
eng
ind
eng
ara
eng
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.beringlab.com
POST Endpoint: /v1/text-translate
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 Endpoint: /v1/text-translate/status/[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