> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Introduction

## Article: Introduction

## Article Link: https://dev.wix.com/docs/api-reference/business-management/multilingual/machine-translation/machine-translation/introduction.md

## Article Content:

# About the Machine Translation API

The Machine Translation API allows you to render text from one language to another helping your site content reach international audiences. When you call this method, Wix sends the content to an external translation service and then returns the translated content. 

With the Machine Translation API, you can:

- Translate text from plain text, HTML, or rich content objects
- Bulk translate up to 1,000 units of text

The Machine Translation API should be used alongside the [Credit Data API](https://dev.wix.com/docs/rest/business-management/multilingual/machine-translation/credit-data/introduction.md) to monitor word credits before and after translation requests.

## Before you begin

It's important to note the following before starting to code:

- A Wix user must install the [Wix Multilingual app](https://www.wix.com/app-market/wix-multilingual?searchLocation=home) on their site. 
- Wix doesn't overwrite the original content source. Make sure to store the returned `translatedContent` object separately to use at a later time.
- Only text translation is supported.
- Translation requests are limited to 5,000 characters.
- Translation requests fail if the site has insufficient [word credits](#terminology). Use the [Credit Data API](https://dev.wix.com/docs/rest/business-management/multilingual/machine-translation/credit-data/introduction.md) to check credit availability.
- Successful translation requests automatically deduct credits from the site's word credit balance.


## Use case

+ [Translate a blog post with credit validation](https://dev.wix.com/docs/api-reference/business-management/multilingual/machine-translation/machine-translation/sample-flow.md)

## Terminology

- **Machine translation**: The process of using an external service to automatically translate text to other languages. Alternatively, a Wix user can manually translate their content with the [Translation Manager](https://support.wix.com/en/article/wix-multilingual-using-the-translation-manager).
- **Translatable content**: Content that can be machine translated with the Machine Translation API. Learn more about [translatable and untranslatable content](https://support.wix.com/en/article/wix-multilingual-translatable-content).
- **Word credit**: A unit of translation capacity. 1 credit equals 1 word. Every site has a word credit balance indicating the number of words available for translation.
- **Quota**: The total number of word credits allocated to a site, including initial allocation and any additional credits purchased through the [Translation Manager](https://support.wix.com/en/article/wix-multilingual-using-the-translation-manager). Currently, sites have a quota limit, with the exception of [Wix Studio enterprise sites](https://support.wix.com/en/article/wix-enterprise-an-overview), which have an unlimited quota.

@sdk_package_setup