The Azure AI Translator connector provides a complete integration with the Azure AI Translator (AAIT) REST API, enabling multilingual processing capabilities for both text and documents. It exposes a set of server actions that cover the essential features of the AAIT service while abstracting away the underlying API complexity.

1. Free-Text Translation

The connector wraps the AAIT Text Translate API endpoint.
Key capabilities:

• Handles auto-detection of source language

• Returns a normalized response structure that includes detected language, translated text, and confidence scores

2. Fetching Supported Languages

The connector integrates with the Get Languages API to retrieve metadata about supported translation languages.
Included features:

• Normalization of dynamic JSON structures, ensuring a predictable Key:Value list for each language code

• Used to populate dropdowns, validate requests, or drive dynamic UI

3. Synchronous Document Translation

The connector implements the synchronous single document translation capability provided by Azure AI Translator for specific file types (e.g., .docx, .xlsx, .pptx, .txt, .csv, .html). It wraps the Document Translation API endpoint.
Features include:

• Accepts a binary file input and forwards it to AAIT using the appropriate content type

• Supports real-time translation without queues or storage accounts

• Returns the translated binary file directly in the response

IMPORTANT:

Synchronous document translation does not support PDF translations. For PDF Translations, batch processing (asynchronous) is required.

4. Supported Document Formats

                                                                                                                           

                                                                                    

Format Type	Extensions	Batch Support	Sync Support	Notes
PDF	.pdf	?	X	OCR-based translation for scanned PDFs - only in batch
Word	.doc, .docx	?	? (.docx only)	Legacy .doc converted to .docxin batch
Excel	.xls, .xlsx	?	? (.xlsx only)	Legacy .xls converted to .xlsxin batch
PowerPoint	.ppt, .pptx	?	? (.pptx only)	Legacy .ppt converted to .pptxin batch
Plain Text	.txt	?	?	UTF-8 encoded
CSV	.csv	?	?	Comma-delimited
Tab-separated	.tsv, .tab	?	?	Tab-delimited
HTML	.html, .htm	?	?	Web page markup
MHTML	.mhtml, .mht	?	?	Web archive; multipart/related content-type
Markdown	.md, .markdown,   .mdown, .mkdn, .mkd, .mdwn, .mdtxt, .mdtext, .rmd	?	X	Only batch mode
OpenDocument Text	.odt	?	X	Legacy .odt converted to .docxin batch
OpenDocument Presentation	.odp	?	X	Legacy .odp converted to .pptxin batch
OpenDocument Spreadsheet	.ods	?	X	Legacy .ods converted to .xlsxin batch
Outlook Email	.msg	?	?	Single document or batch
XLIFF	.xlff       .xlf       .xliff	?   (.xlff only)	?   (.xlf .xliff only)	XML Localization Interchange File Format
Rich Text Format	.rtf	?	X	Legacy .rtf converted to .docxin batch

5. Authentication

1. Global resource:

2. Regional resource: 

6. Service Limits

https://learn.microsoft.com/en-us/azure/ai-services/translator/service-limits

7. Prerequisites

1. Active Azure Subscription

2. Azure AI Translator Resource in one of the supported regions. 

This would give you the subscription key, region key, and the document translation API endpoint.

Examples of supported regions:

1. West Europe

2. North Europe

3. East US

4. West US

5. Southeast Asia

6. Japan East

7. Australia East

(Some regions do not support Translator.)

3. Tier requirements:

1. Text Translation: S0 or higher
2. Synchronous Document Translation: S1 or higher
3. Batch Document Translation: S1 or higher

4. Azure Blob Storage Account (Batch Only)

Only required for batch document translation:

1. One container for source files
2. One container for output files
3. SAS URLs for both containers