Installation

The package is available at nuget.org and it can be installed via package manager console by executing following command:

PM> NuGet\Install-Package GroupDocs.Translation-Cloud

Multilingual Translation Cloud REST API

GroupDocs.Translation Cloud offers a robust and versatile API for seamless file and text translation across 46 languages. Maintain the original layout and formatting of your documents, including Word files, Excel spreadsheets, PDFs, and more, while ensuring accurate and efficient translation. Leverage powerful OCR capabilities to translate scanned documents and images. With easy API management and a wide range of supported file formats, GroupDocs.Translation Cloud streamlines your translation workflow for various content types.

Files & Text Translation

Translating Files

Send various file formats such as Word, Excel, PDFs, and more for translation via the GroupDocs.Translation Cloud API.

Translating Texts

Translate plain text using the GroupDocs.Translation SDK and fetch translated output in real time.

Document Translation

Translating Word Files

Translate Word documents (DOC, DOCX, DOCM) while maintaining their original layout and formatting.

Translating Excel Files

Send Excel and ODS files for translation, preserving spreadsheet structure and cell formatting.

Translating PDF Files

Translate PDF documents with options to keep document formatting and structure intact during the translation.

Translating PowerPoint Files

Translate PowerPoint and ODP files, retaining slide formatting and layout across all translated versions.

Subtitle and Resource File Translation

Translating Srt Files

Translate subtitle files in SRT format, maintaining timing and structure for multilingual media.

Translating Resx Files

Translate Resx files for localization and resource management, keeping key-value pairs intact during translation.

Web and Code File Translation

Translating HTML Files

Translate HTML files while preserving inline styles, scripts, and formatting to maintain web content structure.

Translating Markdown Files

Translate Markdown files, preserving syntax, formatting, and content structure throughout the translation process.

Image and Scanned Document Translation

Translating Image and Scanned PDF Files

Translate image files and scanned PDFs into text or other formats using OCR capabilities. Supports converting output into formats such as plain text or translated PDFs.

CSV and Data File Translation

Translating CSV Files

Translate CSV files and receive translated output in a structured CSV format, ensuring data integrity.

API Management

Sending Files for Translation

Upload files to the GroupDocs.Translation Cloud API for translation, managing file submissions and tracking progress.

Fetching Translations

Retrieve translated files or text using a task ID once the translation task is completed, via the GroupDocs.Translation API.

Supported File Formats for Translation

GroupDocs.Translation Cloud supports a wide range of popular file formats, ensuring accurate preservation of layout, structure, and formatting during translation.

Note: We recommend opening translated files in the same or newer version of the application used to create the original document for full compatibility.

Supported Conversion Formats

GroupDocs.Translation Cloud can convert translated documents into various file formats, preserving formatting where applicable.

Supported Translation Languages (46)

Afrikaans (AF), Arabic (AR), Armenian (HY), Azerbaijani (AZ), Bengali (BN), Bulgarian (BG), Catalan (CA), Chinese (ZH), Croatian (HR), Czech (CS), Danish (DA), Dutch (NL), English (EN), Estonian (ET), Farsi (FA), Finnish (FI), French (FR), Georgian (KA), German (DE), Greek (EL), Hebrew (HE), Hindi (HI), Hungarian (HU), Indonesian (ID), Irish (GA), Italian (IT), Japanese (JA), Korean (KO), Latvian (LV), Lithuanian (LT), Malay (MS), Norwegian (NO), Polish (PL), Portuguese (PT), Romanian (RO), Russian (RU), Serbian (SR), Slovak (SK), Spanish (ES), Swedish (SV), Tagalog (TL), Thai (TH), Turkish (TR), Ukrainian (UK), Urdu (UR), Vietnamese (VI).

Language Translation Pairs

Direct Language Pairs (140)

GroupDocs.Translation Cloud offers 140 direct language pairs, focusing on popular European, Middle Eastern, and Asian languages for universal translation. English (EN) serves as the central pivot language for most pairs.

English (EN) pairs with

Afrikaans (AF), Arabic (AR), Armenian (HY), Azerbaijani (AZ), Bengali (BN), Bulgarian (BG), Catalan (CA), Chinese (ZH), Croatian (HR), Czech (CS), Danish (DA), Dutch (NL), Estonian (ET), Farsi (FA), Finnish (FI), French (FR), Georgian (KA), German (DE), Greek (EL), Hebrew (HE), Hindi (HI), Hungarian (HU), Indonesian (ID), Irish (GA), Italian (IT), Japanese (JA), Korean (KO), Latvian (LV), Lithuanian (LT), Malay (MS), Norwegian (NO), Polish (PL), Portuguese (PT), Romanian (RO), Russian (RU), Serbian (SR), Slovak (SK), Spanish (ES), Swedish (SV), Tagalog (TL), Thai (TH), Turkish (TR), Ukrainian (UK), Urdu (UR), Vietnamese (VI).

Asian Language Translation Pairs

Chinese (ZH)

Chinese (ZH) <-> English (EN), French (FR), German (DE), Italian (IT), Polish (PL), Portuguese (PT), Russian (RU), Spanish (ES)

Japanese (JA)

Japanese (JA) <-> English (EN)

Korean (KO)

Korean (KO) <-> English (EN)

Bengali (BN)

Bengali (BN) <-> English (EN)

Tagalog (TL)

Tagalog (TL) <-> English (EN)

Thai (TH)

Thai (TH) <-> English (EN)

Vietnamese (VI)

Vietnamese (VI) <-> English (EN)

Indonesian (ID)

Indonesian (ID) <-> English (EN)

Malay (MS)

Malay (MS) <-> English (EN)

Hindi (HI)

Hindi (HI) <-> English (EN)

European Languages

Afrikaans (AF)

Afrikaans (AF) <-> English (EN)

Armenian (HY)

Armenian (HY) <-> English (EN)

Azerbaijani (AZ)

Azerbaijani (AZ) <-> English (EN)

Bulgarian (BG)

Bulgarian (BG) <-> English (EN)

Catalan (CA)

Catalan (CA) <-> English (EN)

Croatian (HR)

Croatian (HR) <-> English (EN)

Czech (CS)

Czech (CS) <-> English (EN)

Danish (DA)

Danish (DA) <-> English (EN)

Dutch (NL)

Dutch (NL) <-> English (EN)

Estonian (ET)

Estonian (ET) <-> English (EN)

Finnish (FI)

Finnish (FI) <-> English (EN)

French (FR)

French (FR) <-> Arabic (AR), Chinese (ZH), English (EN), German (DE), Italian (IT), Polish (PL), Portuguese (PT), Russian (RU), Spanish (ES)

German (DE)

German (DE) <-> Arabic (AR), Chinese (ZH), English (EN), French (FR), Italian (IT), Polish (PL), Portuguese (PT), Russian (RU), Spanish (ES)

Georgian (KA)

Georgian (KA) <-> English (EN)

Greek (EL)

Greek (EL) <-> English (EN)

Hungarian (HU)

Hungarian (HU) <-> English (EN)

Irish (GA)

Irish (GA) <-> English (EN)

Italian (IT)

Italian (IT) <-> Arabic (AR), Chinese (ZH), English (EN), French (FR), German (DE), Polish (PL), Portuguese (PT), Russian (RU), Spanish (ES)

Latvian (LV)

Latvian (LV) <-> English (EN)

Lithuanian (LT)

Lithuanian (LT) <-> English (EN)

Norwegian (NO)

Norwegian (NO) <-> English (EN)

Polish (PL)

Polish (PL) <-> Arabic (AR), Chinese (ZH), English (EN), French (FR), German (DE), Italian (IT), Portuguese (PT), Russian (RU), Spanish (ES)

Portuguese (PT)

Portuguese (PT) <-> Arabic (AR), Chinese (ZH), English (EN), French (FR), German (DE), Italian (IT), Polish (PL), Russian (RU), Spanish (ES)

Romanian (RO)

Romanian (RO) <-> English (EN)

Russian (RU)

Russian (RU) <-> Arabic (AR), Chinese (ZH), English (EN), French (FR), German (DE), Italian (IT), Polish (PL), Portuguese (PT), Spanish (ES)

Serbian (SR)

Serbian (SR) <-> English (EN)

Slovak (SK)

Slovak (SK) <-> English (EN)

Spanish (ES)

Spanish (ES) <-> Arabic (AR), Chinese (ZH), English (EN), French (FR), German (DE), Italian (IT), Polish (PL), Portuguese (PT), Russian (RU)

Swedish (SV)

Swedish (SV) <-> English (EN)

Middle Eastern Languages

Arabic (AR)

Arabic (AR) <-> English (EN), French (FR), German (DE), Italian (IT), Polish (PL), Portuguese (PT), Russian (RU), Spanish (ES), Turkish (TR)

Farsi (FA)

Farsi (FA) <-> English (EN)

Hebrew (HE)

Hebrew (HE) <-> English (EN)

Turkish (TR)

Turkish (TR) <-> Arabic (AR), English (EN)

Ukrainian (UK)

Ukrainian (UK) <-> English (EN)

Urdu (UR)

Urdu (UR) <-> English (EN)

Multi-step Translation

Direct language pairs ensure the most accurate translations, closely matching the original content while minimizing errors. However, if your desired language pair isn’t available, you can use English or French as a pivot language to bridge the gap.

For example, to translate from Greek to Chinese:

1. First, translate from Greek to English.
2. Then, translate the English result to Chinese.

Please keep in mind that using a pivot language might slightly reduce translation quality compared to direct language pairs.

Supported Content Formatting

GroupDocs.Translation Cloud ensures that layout, structure, and formatting are preserved during translation, even for complex documents. Below is the list of document formatting elements that are guaranteed to be processed.

Note: Some inline text styles may not be fully retained during translation, depending on the file format and the structure of the target language.

System Requirements

GroupDocs.Translation Cloud is an on-demand service, meaning it has no specific device or OS requirements. It can be accessed using any programming language that supports HTTPS requests.

Note: GroupDocs.Translation Cloud works across all devices and operating systems, as long as they support HTTPS and have internet access.

Getting Started

1. Sign Up and Account Setup

1. Create an Account: Go to GroupDocs Cloud API.

   • If you’re already registered, sign in with your credentials.
   • If not, click Don’t have an account? Sign Up and follow the steps.

2. Subscription Plans: Review subscription plans and free-tier limits.

3. Privacy & Security: GroupDocs values your privacy. Refer to our Privacy Policy and Terms of Service for more information.

2. Get an Access Token

GroupDocs uses JWT authentication for secure data transfer. To get your access token:

1. Obtain Client ID and Secret:

   • Sign in to the GroupDocs Cloud API Dashboard.
   • Navigate to Applications, create storage for your files, provide an application name (e.g., HelloWorld), and copy the Client ID and Client Secret.

2. Request Access Token: Use the following cURL command:

   curl --location --request POST 'https://id.groupdocs.cloud/connect/token' \
     --data-urlencode 'grant_type=client_credentials' \
     --data-urlencode 'client_id=CLIENT-ID-VALUE' \
     --data-urlencode 'client_secret=CLIENT-SECRET-VALUE'
   

   The response will include your access token:

   {
      "access_token": "YOUR_ACCESS_TOKEN",
      "expires_in": 3600,
      "token_type": "Bearer"
   }
   

3. Translate Text Using GroupDocs.Translation API

Now that you have your access token, follow these steps to translate text:

1. Send Text for Translation: Use the cURL command to send a translation request from English to German:

   curl --location --request POST 'https://api.groupdocs.cloud/v2.0/translation/text' \
   --header 'Content-Type: application/json' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --data '{
      "sourceLanguage": "en",
      "targetLanguages": ["de"],
      "texts": ["Hello, world! I can read this text in my language."]
   }'
   

   You will receive a unique request ID:

   {
      "status": 202,
      "message": "Starting translation",
      "id": "cb87bd7c-4660-4044-88c7-2b30edb44a4d"
   }
   

2. Retrieve Translated Text: Use the unique request ID to fetch the translated text:

   curl --location 'https://api.groupdocs.cloud/v2.0/translation/text/cb87bd7c-4660-4044-88c7-2b30edb44a4d' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
   

   The translated text will be returned:

   {
      "status": 200,
      "message": "Text translated successfully",
      "translations": {
         "de": ["Hallo, Welt! Ich kann diesen Text in meiner Sprache lesen."]
      }
   }
   

All URIs are relative to https://api.groupdocs.cloud/v2.0/translation

Documentation for Models

CloudFileResponse, CloudHugoResponse, CloudTextResponse, CsvFileRequest, FileRequest, HealthCheckStatus, HtmlFileRequest, HttpStatusCode, HugoRequest, ImageToFileRequest, ImageToTextRequest, LanguagePairData, MarkdownFileRequest, PdfFileRequest, PresentationFileRequest, ResxFileRequest, SpreadsheetFileRequest, StatusResponse, StringStringTuple, TextDocumentFileRequest, TextRequest, UrlFileInfo, WorksheetData

GroupDocs.Translation Cloud SKDs

GitHub

Package Manager