Exercise - Create Translator service

  • 10 minutes

Let's get keys for the Translator service. As mentioned previously, we'll need an Azure account. We'll create the key using the Azure portal and store it in a .env file in our application.

Get Translator service key

  1. Browse to the Azure portal

  2. Select Create a resource

    Screenshot showing the Create a resource option in the Azure portal.

  3. In the Search box, enter Translator

  4. Select Translator

    Translator search results.

  5. Select Create

    Screenshot showing the Translator create dialog.

  6. Complete the Create Translator form with the following values:

    • Subscription: Your subscription
    • Resource group:
      • Select Create new
      • Name: flask-ai
    • Resource group region: Select a region near you
    • Resource region: Select the same region as above
    • Name: A unique value, such as ai-yourname
    • Pricing tier: Free F0

    Screenshot showing the completed Translator create form.

  7. Select Review + create

  8. Select Create

  9. After a few moments the resource will be created

  10. Select Go to resource

  11. Select Keys and Endpoint on the left side under RESOURCE MANAGEMENT

    Screenshot showing the keys and endpoints option on the menu.

  12. Next to KEY 1, select Copy to clipboard

    Screenshot showing the key dashboard.

    Note

    There's no difference between Key 1 and Key 2. By providing two keys you have the opportunity to migrate to new keys, by regenerating one while using the other.

  13. Make a note of the Text Translation and location values

Create .env file to store the key

  1. Return to Visual Studio Code and create a new file in the root of the application by selecting New file and naming it .env

    Important

    The . at the beginning of the file is required.

  2. Paste the following text into .env

    KEY=your_key
ENDPOINT=your_endpoint
LOCATION=your_location

  3. Replace the placeholders

    • your_key with the key you copied above
    • your_endpoint with the endpoint from Azure
    • your_location with the location from Azure

  4. Your .env file should look like the following (with your values):

    KEY=00d09299d68548d646c097488f7d9be9
ENDPOINT=https://api.cognitive.microsofttranslator.com/
LOCATION=westus2

Next steps

Now that our Translator service is configured and variables are set in .env, we can turn our attention to adding the necessary code!