Retrieving Parameters for Azure Translation Service Integration

Overview

This document provides a guide to set up an Azure account and retrieve necessary parameters for integrating with the Azure Translation Service.

Unfortunately, even if this service is free, users must first subscribe to Azure services. The free tier has a limit of 2 million characters per month. Have this in mind when you translate subtitles.

Steps to Retrieve Parameters

1. Create an Azure Account

If you do not have an Azure account, follow these steps to create one:

• Visit the Azure website: Azure’s website.
• Click on the “Start free” option to sign up.
• Follow the on-screen instructions to complete the account setup, which may include providing your email address, creating a Microsoft account, and entering payment information for account verification.

2. Create a Translator Resource

Once your Azure account is set up, create a Translator resource by following these steps:

• Log in to the Azure Portal.
• Click on “Create a resource” in the top-left corner of the dashboard.
• In the search bar, type “Translator” and hit enter.
• Select “Translator” from the search results and click “Create”.
• Fill in the details for the new resource:
  • Subscription: Choose your Azure subscription.
  • Resource group: Create a new resource group or select an existing one. A resource group is a container that holds related resources.
  • Region: Select the geographical location closest to you or your users. This determines where your resource is hosted.
  • Name: Give your Translator resource a unique name.
  • Pricing tier: Select a pricing tier that suits your needs. Azure offers a free tier for limited use.
• Review and create the resource.

3. Obtain Subscription Key and Base URL

After creating the Translator resource, you need to retrieve the subscription key and base URL:

• Navigate to your newly created Translator resource in the Azure portal.
• In the “Overview”, locate the “Manage keys” and “Endpoints” links.
• Here, you will find two keys provided; you can use either. Copy the key; this is your Subscription Key.
• The “Location/Region” is your Region.
• The base “Text Translation” URL plus the location of the translator endpoint is your Base URL. An example given the Global resource is
  https://api.cognitive.microsofttranslator.com/translate?api-version=3.0
  

Note on Azure site, they usually provide only the base URL, not the full endpoint. It is important to use the full endpoint to use the service.

Setup Jubler

Inside the Translation tool, use the Configure button to provide this information to the system. Note, you also need to provide a PIN code, to securely store the subscription key to disk. Use whatever password/passphrase you like, it’s up to you. Every time you launch Jubler, you will need to provide this password again.