---
id: azure-ai-translation-document
version: "2.0.0"
license: MIT License
license_treatment: permissive
maintenance: active
---

# azure-ai-translation-document — Microsoft Azure Ai Translation Document Client Library for Python

License: permissive · Maintenance: active · Downloads: 377.3K/mo

## What it is and what it does

This package is a Python client for Azure's Document Translation service, a cloud-based API that translates multiple documents stored in Azure Blob Storage containers while maintaining their original structure and formatting. It handles the orchestration of translation jobs across languages and dialects, allowing you to specify source and target storage containers and monitor translation progress document-by-document.

The client abstracts away the complexity of calling Azure's translation REST API directly. It depends on azure-core for credential handling and HTTP communication, isodate for date parsing, and typing-extensions for type hints. You authenticate with either an API key or Azure Active Directory, then call begin_translation() to start a batch job, optionally applying custom translation models or glossaries to tailor results to your domain.

Use it for:

- Translate a batch of PDFs or Word documents from one language to another while keeping formatting intact for downstream processing.
- Build a multilingual content pipeline that automatically translates documents uploaded to a source blob container and writes results to a target container.
- Monitor the progress of individual documents within a large translation operation to track completion and identify failures.
- Apply domain-specific glossaries or custom translation models to ensure terminology consistency in technical or specialized documents.
- Enumerate past and current translation operations to audit translation history and retrieve previously translated documents.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Translates documents stored in Azure Blob Storage across languages while preserving structure and format, with support for custom translation models and glossaries.

Yes. The package is actively maintained, has low install friction, carries a permissive MIT license, and integrates cleanly with Azure's ecosystem. It is suitable for any Python project that needs to translate documents at scale while preserving formatting. No known vulnerabilities. Requires an Azure subscription and Translator resource to be useful.

## Install

pip install azure-ai-translation-document
uv add azure-ai-translation-document
poetry add azure-ai-translation-document

## Installing azure-ai-translation-document

Before you install: Low install friction with a pure Python wheel. Actively maintained with a release 16 days old; repository shows consistent activity and no archived status.

License in practice: MIT License permits commercial and private use with minimal restrictions; suitable for most projects.

Quickstart:

pip install azure-ai-translation-document

from azure.core.credentials import AzureKeyCredential
from azure.ai.translation.document import DocumentTranslationClient

client = DocumentTranslationClient(endpoint, AzureKeyCredential(key))
poller = client.begin_translation(source_url, target_url, target_language)

Requires Python 3.9 or later. Requires an active Azure subscription and Translator resource with endpoint and API key or Azure Active Directory credentials.

Verify before relying:

- Whether custom translation models and glossaries are fully integrated or require separate setup steps beyond this client library.
- Performance characteristics and throughput limits for large-scale batch document translation operations.
- Whether the service version 2026-03-01 mentioned in the description is current or if newer versions are available.

## Package facts

- License: MIT License (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 377.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

azure document translation, batch document translation, azure blob storage translation, multilingual document processing, cloud document translation service, preserve document format translation, azure cognitive services translation, azure-sdk, document-translation, batch-processing

[View on SkillFed](https://skillfed.io/packages/azure-ai-translation-document) · [View on PyPI](https://pypi.org/project/azure-ai-translation-document/)