CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl/pypi-azure-ai-translation-text

Azure Text Translation client library for Python that provides neural machine translation technology for quick and accurate source-to-target text translation in real time across all supported languages

—

Pending

Quality

Pending

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Overview
Eval results
Files

index.mddocs/

Azure AI Translation Text

Azure Text Translation is a neural machine translation service that provides quick and accurate real-time translation between languages, script transliteration, language detection, and dictionary operations. Built on Azure's cognitive services infrastructure, it offers enterprise-grade reliability and supports over 100 languages with advanced features like profanity filtering, text alignment, and custom translation models.

Package Information

  • Package Name: azure-ai-translation-text
  • Package Type: pypi
  • Language: Python
  • Installation: pip install azure-ai-translation-text

Core Imports

from azure.ai.translation.text import TextTranslationClient
from azure.core.credentials import AzureKeyCredential

Async version:

from azure.ai.translation.text.aio import TextTranslationClient

Basic Usage

from azure.ai.translation.text import TextTranslationClient
from azure.core.credentials import AzureKeyCredential

# Create client with API key and region
credential = AzureKeyCredential("your-api-key")
client = TextTranslationClient(credential=credential, region="your-region")

# Translate text to multiple languages
response = client.translate(
    body=["Hello, world!"],
    to_language=["es", "fr", "de"]
)

# Print translations
translation = response[0]
for translated_text in translation.translations:
    print(f"Language: {translated_text.to}, Translation: {translated_text.text}")

Architecture

The client provides access to Azure's Text Translation service through these key components:

  • TextTranslationClient: Main synchronous client for all translation operations
  • TextTranslationClient (aio): Asynchronous version for high-performance applications
  • Authentication: Supports both API key and Azure AD token-based authentication
  • Regional Endpoints: Optimized routing based on resource region and global endpoints
  • Request Models: Typed input structures for all operations
  • Response Models: Comprehensive result objects with metadata and error handling

Capabilities

Language Support

Query supported languages for translation, transliteration, and dictionary operations. Get comprehensive language metadata including native names, directionality, and regional variants.

def get_supported_languages(
    *,
    client_trace_id: Optional[str] = None,
    scope: Optional[str] = None,
    accept_language: Optional[str] = None,
    etag: Optional[str] = None,
    match_condition: Optional[MatchConditions] = None,
    **kwargs: Any
) -> GetSupportedLanguagesResult

Language Support

Text Translation

Neural machine translation between supported languages with advanced options for content filtering, text alignment, sentence boundary detection, and custom model support.

def translate(
    body: Union[List[str], List[InputTextItem], IO[bytes]],
    *,
    to_language: List[str],
    client_trace_id: Optional[str] = None,
    from_language: Optional[str] = None,
    text_type: Optional[Union[str, TextType]] = None,
    category: Optional[str] = None,
    profanity_action: Optional[Union[str, ProfanityAction]] = None,
    profanity_marker: Optional[Union[str, ProfanityMarker]] = None,
    include_alignment: Optional[bool] = None,
    include_sentence_length: Optional[bool] = None,
    suggested_from: Optional[str] = None,
    from_script: Optional[str] = None,
    to_script: Optional[str] = None,
    allow_fallback: Optional[bool] = None,
    **kwargs: Any
) -> List[TranslatedTextItem]

Text Translation

Script Transliteration

Convert text between different scripts (e.g., Latin to Cyrillic, Arabic to Latin) while preserving pronunciation and meaning within the same language.

def transliterate(
    body: Union[List[str], List[InputTextItem], IO[bytes]],
    *,
    language: str,
    from_script: str,
    to_script: str,
    client_trace_id: Optional[str] = None,
    **kwargs: Any
) -> List[TransliteratedText]

Script Transliteration

Sentence Boundary Detection

Identify sentence boundaries in text with automatic language detection and script-specific processing for proper text segmentation.

def find_sentence_boundaries(
    body: Union[List[str], List[InputTextItem], IO[bytes]],
    *,
    client_trace_id: Optional[str] = None,
    language: Optional[str] = None,
    script: Optional[str] = None,
    **kwargs: Any
) -> List[BreakSentenceItem]

Sentence Boundary Detection

Dictionary Operations

Bilingual dictionary lookups providing alternative translations, part-of-speech information, usage frequency, and contextual examples for translation pairs.

def lookup_dictionary_entries(
    body: Union[List[str], List[InputTextItem], IO[bytes]],
    *,
    from_language: str,
    to_language: str,
    client_trace_id: Optional[str] = None,
    **kwargs: Any
) -> List[DictionaryLookupItem]

def lookup_dictionary_examples(
    body: Union[List[DictionaryExampleTextItem], IO[bytes]],
    *,
    from_language: str,
    to_language: str,
    client_trace_id: Optional[str] = None,
    **kwargs: Any
) -> List[DictionaryExampleItem]

Dictionary Operations

Authentication Types

API Key Authentication

class AzureKeyCredential:
    def __init__(self, key: str): ...

class TranslatorAuthenticationPolicy:
    def __init__(self, credential: AzureKeyCredential, region: str): ...

Azure AD Authentication

class TranslatorEntraIdAuthenticationPolicy:
    def __init__(
        self,
        credential: TokenCredential,
        resource_id: str,
        region: str,
        audience: str,
        **kwargs: Any
    ): ...

Core Types

Input Models

class InputTextItem:
    text: str

class DictionaryExampleTextItem:
    text: str
    translation: str

Client Configuration

class TextTranslationClient:
    def __init__(
        self,
        *,
        credential: Optional[Union[AzureKeyCredential, TokenCredential]] = None,
        region: Optional[str] = None,
        endpoint: Optional[str] = None,
        resource_id: Optional[str] = None,
        audience: Optional[str] = None,
        api_version: str = "3.0",
        **kwargs
    ): ...
    
    def close(self) -> None: ...
    def __enter__(self) -> "TextTranslationClient": ...
    def __exit__(self, *exc_details: Any) -> None: ...

Enumerations

class TextType(str, Enum):
    PLAIN = "Plain"
    HTML = "Html"

class ProfanityAction(str, Enum):
    NO_ACTION = "NoAction"
    MARKED = "Marked"
    DELETED = "Deleted"

class ProfanityMarker(str, Enum):
    ASTERISK = "Asterisk"
    TAG = "Tag"

class LanguageDirectionality(str, Enum):
    LTR = "ltr"
    RTL = "rtl"

Install with Tessl CLI

npx tessl i tessl/pypi-azure-ai-translation-text

docs

dictionary-operations.md

index.md

language-support.md

script-transliteration.md

sentence-boundaries.md

text-translation.md

tile.json