Azure AI Translator with Python (CLI + SDK)

Overview

This project demonstrates how to use Azure AI Translator with Python and Azure CLI to translate text programmatically.

It includes:

• Python translation scripts
• Azure CLI integration to retrieve credentials
• Environment variable-based authentication
• CLI-based custom translation tool

---

Project Structure

Translator-using-Azure-AI-and-Python/
│
├── text-translation-app.py
├── translate-custom-text.py
├── check-translator-config.py
├── requirements.txt
└── README.md

---

Prerequisites

Install:

• Python 3
• Azure CLI
• Azure AI Translator resource (created via Terraform or Portal)

---

Install Azure CLI

brew install azure-cli

Login:

az login

---

Setup Python Environment

python3 -m venv venv
source venv/bin/activate

Install dependencies:

pip install -r requirements.txt

---

Get Translator Credentials (Azure CLI)

Set variables:

RESOURCE_GROUP="rg_eastus_XXXXX"
TRANSLATOR_NAME="translator-demo-XXXXX"

Get endpoint:

az cognitiveservices account show \
  --name $TRANSLATOR_NAME \
  --resource-group $RESOURCE_GROUP \
  --query "properties.endpoint" \
  --output tsv

Get region:

az cognitiveservices account show \
  --name $TRANSLATOR_NAME \
  --resource-group $RESOURCE_GROUP \
  --query "location" \
  --output tsv

Get key:

az cognitiveservices account keys list \
  --name $TRANSLATOR_NAME \
  --resource-group $RESOURCE_GROUP \
  --query "key1" \
  --output tsv

---

Set Environment Variables

macOS/Linux

export TRANSLATOR_KEY="<your-key>"
export TRANSLATOR_ENDPOINT="<your-endpoint>"
export TRANSLATOR_REGION="eastus"

Windows PowerShell

$env:TRANSLATOR_KEY="<your-key>"
$env:TRANSLATOR_ENDPOINT="<your-endpoint>"
$env:TRANSLATOR_REGION="eastus"

---

Validate Configuration

python3 check-translator-config.py

Expected:

TRANSLATOR_KEY: SET
TRANSLATOR_ENDPOINT: https://...
TRANSLATOR_REGION: eastus

---

Run Default Translation App

python3 text-translation-app.py

Output:

Text was translated to 'es' and the result is: Esta es una prueba
Text was translated to 'it' and the result is: Questo è un test

---

Run Custom Translator CLI

python3 translate-custom-text.py \
  --text "Hello, this is my project" \
  --to es it fr

Output:

es: Hola, este es mi proyecto
it: Ciao, questo è il mio progetto
fr: Bonjour, c'est mon projet

---

Skills Demonstrated

• Azure AI Translator
• Python SDK usage
• Azure CLI integration
• Secure credential handling
• CLI tool development
• API interaction
• Error handling