This article will guide you through the process of configuring your own Machine Translation (MT) provider on BWX, and the credentials required for their utilization.

1. Certified providers

2. Configuring your MT

3. Setting up the configuration at both the Organization and Organizational Unit levels

4. Credential details

1. Certified providers

Currently, it is possible to link credentials for the following Machine Translation providers to BWX:

1. Amazon Translate
2. Google Cloud Translation API
3. Microsoft Azure Cognitive Services Translation API
4. DeepL API

These providers offer powerful machine translation services that can be integrated with BWX to enhance translation capabilities.

BWX utilizes Microsoft Azure as its standard Machine Translation (MT) service, accessible to all users who activate the MT features in their individual accounts.

It is possible to link a personal or business credential from another provider to BWX. This can be set at the Account level, making it available for your entire account, as well as at the Organization (Org) and Organizational Unit (Org Unit) level, making it available only for the projects associated with it.

2. Configuring your MT

In the left menu, go to Settings, and click on My Account.

On the MT settings tab, you must then enter the fields in order to associate your credentials with BWX.

The new MT provider can be defined as the default provider (being used in all your account projects) or you can define specific language pairs for it. 

1. Define a name for this configuration;
2. Select the provider;
3. Set as default;
4. Or define the language pair;
5. Insert the credentials;
6. You may also upload the credentials in JSON format.

3. Setting up the configuration at both the Organization and Organizational Unit levels

Once the new credential has been added to your account, you can choose to apply it at either the Organization or Organizational Unit level.

Within the MT settings, you will find the option to select and customize the preferred credential for a specific Organization or Organizational Unit. This selection enables you to utilize the designated credential for projects associated with the corresponding Organization or Organizational Unit.

• Organization: Open the desired organization and go to the MT settings tab:

• Organizational Unit: Access the specific Organizational Unit in BWX and navigate to the MT settings tab:

In both settings, you will be able to:

1. Choose the default provider;
2. Set up multiple language pairs.

The configuration by language pair can be done for as many pairs as needed. You can also set up multiple MT providers for different language pairs. For example, you can use Google to translate from en-US to pt-BR and use AWS to translate from en-US to ES (Spanish). You just need to have the necessary providers registered in your account beforehand.

By having multiple MT providers linked to your BWX account, you gain the flexibility to choose the most suitable provider for each language pair based on their strengths and capabilities. This allows you to leverage different translation engines for different language combinations, optimizing the translation quality and results.

To configure the language pairs, click on the Add Language Pair button:

You must then fill in the information:

1. Choose the MT provider;
2. Select the source language;
3. And the target language;
4. You may set this configuration as active, or inactivate an existing one.

⚠️ Remember to click on "Save".

4. Credential details

It is important to remember that the processes for obtaining credentials and keys may vary for each translation service provider. It is recommended to consult the specific provider's documentation or contact their support for precise instructions on how to obtain the correct credentials to use their translation services.

These credentials, or keys, need to be obtained directly from each provider and are not offered by BWX or Bureau Works.

• For Amazon AWS Translate, you can access it via regular AWS Services. To do this, you'll need to provide your client AWS credentials, which consist of the Access Key ID and Secret Access Key.
• For Google, although Google provides two ways to access its translating resources in the cloud, we currently only support the Service Account approach, the recommended method by Google as it ensures better security, with an OAuth2 format. To utilize this method, you'll need a Service Account Key, which is a more complex JSON file generated in the Google Cloud Console.
• For Microsoft Translate, the translation process takes place through their REST API. To use this service, you must provide a JSON file containing their subscription information to Microsoft/Azure. The expected information is in the format:

  {"endpoint": YOUR_ENDPOINT, "subscription_key": YOUR_SUBSCRIPTION_KEY, "location": LOCATION}

• For DeepL, the translation process takes place through their REST API. Currently our Machine Translation services offer compatibility with DeepL API - both the Pro¹ and Free versions. The integration process requires a  JSON file containing the client credentials such as

  {“key”: YOUR_API_KEY}

Regardless of the engine used, we ensure that sensible data, such as client credentials, is stored in a secure and encrypted database. It is not directly accessed by our system, but through a unique MT config ID generated at the moment the credentials are entered into the system. This ID can also be used to remove the credentials at any time you feel the need to so.

We are continually working on expanding our support for various Machine Translation engines and methods to enhance the overall translation experience for our users. Stay tuned for updates on new integrations and features in the future!

¹ Please note that DeepL API Pro is distinct from the DeepI Pro which is not supported and requires a different partnership with DeepL.

If you have any inquiries or require assistance with this configuration, feel free to reach out directly to our support team at help@bwx.io.