OpenAPI spec for document translation

Upload and translate a document

Upload and Translate a Document

post

/document

Authorizations
Body
source_langenum

Language of the text to be translated. If this parameter is omitted, the API will attempt to detect the language of the text and translate it.

Example: EN
Options: BG, CS, DA, DE, EL, EN, ES, ET, FI, FR, HU, ID, IT, JA, KO, LT, LV, NB, NL, PL, PT, RO, RU, SK, SL, SV, TR, UK, ZH
target_langenumrequired

The language into which the text should be translated.

Example: DE
Options: BG, CS, DA, DE, EL, EN-GB, EN-US, ES, ET, FI, FR, HU, ID, IT, JA, KO, LT, LV, NB, NL, PL, PT-BR, PT-PT, RO, RU, SK, SL, SV, TR, UK, ZH, ZH-HANS
filestring binaryrequired

The document file to be translated. The file name should be included in this part's content disposition. As an alternative, the filename parameter can be used. The following file types and extensions are supported:

  • docx - Microsoft Word Document
  • pptx - Microsoft PowerPoint Document
  • xlsx - Microsoft Excel Document
  • pdf - Portable Document Format
  • htm / html - HTML Document
  • txt - Plain Text Document
  • xlf / xliff - XLIFF Document, version 2.1
  • srt - SRT Document
filenamestring

The name of the uploaded file. Can be used as an alternative to including the file name in the file part's content disposition.

output_formatstring

File extension of desired format of translated file, for example: docx. If unspecified, by default the translated file will be in the same format as the input file.

formalityenum

Sets whether the translated text should lean towards formal or informal language. This feature is only available for certain target languages. Setting this parameter with a target language that does not support formality will fail, unless one of the prefer_... options are used. Possible options are:

  • default (default)
  • more - for a more formal language
  • less - for a more informal language
  • prefer_more - for a more formal language if available, otherwise fallback to default formality
  • prefer_less - for a more informal language if available, otherwise fallback to default formality
Example: prefer_more
Options: default, more, less, prefer_more, prefer_less
glossary_idstring

A unique ID assigned to a glossary.

Example: def3a26b-3e84-45b3-84ae-0c0aaf3525f7
Responses
{
  "document_id": "04DE5AD98A02647D83285A36021911C6",
  "document_key": "0CB0054F1C132C1625B392EADDA41CB754A742822F6877173029A6C487E7F60A"
}

Check document status

Check Document Status

post

/document/{document_id}

Authorizations
Path parameters
document_idstringrequired

The document ID that was sent to the client when the document was uploaded to the API.

Example: 04DE5AD98A02647D83285A36021911C6
Body
document_keystringrequired

The document encryption key that was sent to the client when the document was uploaded to the API.

Example: 0CB0054F1C132C1625B392EADDA41CB754A742822F6877173029A6C487E7F60A
Responses
{
  "document_id": "04DE5AD98A02647D83285A36021911C6",
  "status": "translating",
  "seconds_remaining": 20
}

Download translated document

Download Translated Document

post

/document/{document_id}/result

Authorizations
Path parameters
document_idstringrequired

The document ID that was sent to the client when the document was uploaded to the API.

Example: 04DE5AD98A02647D83285A36021911C6
Body
document_keystringrequired

The document encryption key that was sent to the client when the document was uploaded to the API.

Example: 0CB0054F1C132C1625B392EADDA41CB754A742822F6877173029A6C487E7F60A
Responses

No body

Last updated