azure-ai-translation-document

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 on this page — 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

azure-ai-translation-document on PyPI

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

Evidence: azure_ai_translation_document-2.0.0-py3-none-any.whl

Keywords: azure, azure sdk

Tags

More Linguistic packages