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

language-support.mddocs/

Language Support

Query comprehensive information about languages supported by Azure Text Translation services. This endpoint provides metadata for translation, transliteration, and dictionary operations including language codes, native names, directionality, and available script conversions.

Capabilities

Get Supported Languages

Retrieves the complete set of languages supported by translation, transliteration, and dictionary operations with optional filtering by operation scope.

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

Parameters:

  • client_trace_id: Client-generated GUID for request tracking
  • scope: Comma-separated list filtering results ("translation", "transliteration", "dictionary")
  • accept_language: BCP 47 language tag for localized language names
  • etag: Resource version for caching support
  • match_condition: Conditional request behavior

Returns: Complete language support information organized by operation type

Usage Examples

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

client = TextTranslationClient(
    credential=AzureKeyCredential("your-api-key"),
    region="your-region"
)

# Get all supported languages
response = client.get_supported_languages()

# Print translation languages
if response.translation:
    for code, language in response.translation.items():
        print(f"{code}: {language.name} ({language.native_name})")

# Get only translation languages
translation_only = client.get_supported_languages(scope="translation")

# Get localized names in French
french_names = client.get_supported_languages(accept_language="fr")

Response Types

Language Support Result

class GetSupportedLanguagesResult(dict):
    translation: Optional[Dict[str, TranslationLanguage]]
    transliteration: Optional[Dict[str, TransliterationLanguage]]
    dictionary: Optional[Dict[str, SourceDictionaryLanguage]]

Translation Language Information

class TranslationLanguage:
    name: str  # Display name in requested locale
    native_name: str  # Native language name
    dir: LanguageDirectionality  # Text directionality (ltr/rtl)

Transliteration Language Information

class TransliterationLanguage:
    name: str  # Display name in requested locale
    native_name: str  # Native language name
    scripts: List[LanguageScript]  # Available script conversions

class LanguageScript:
    code: str  # Script identifier
    name: str  # Display name
    native_name: str  # Native script name
    dir: LanguageDirectionality  # Text directionality
    to_scripts: List[TransliterableScript]  # Conversion targets

class TransliterableScript:
    code: str  # Target script identifier
    name: str  # Display name
    native_name: str  # Native script name
    dir: LanguageDirectionality  # Text directionality

Dictionary Language Information

class SourceDictionaryLanguage:
    name: str  # Display name in requested locale
    native_name: str  # Native language name
    dir: LanguageDirectionality  # Text directionality
    translations: List[TargetDictionaryLanguage]  # Available dictionary targets

class TargetDictionaryLanguage:
    code: str  # Target language code
    name: str  # Display name
    native_name: str  # Native language name
    dir: LanguageDirectionality  # Text directionality

Language Directionality

class LanguageDirectionality(str, Enum):
    LTR = "ltr"  # Left-to-right languages (English, Spanish, etc.)
    RTL = "rtl"  # Right-to-left languages (Arabic, Hebrew, etc.)

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