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
—
Quality
Pending
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
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.
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
) -> GetSupportedLanguagesResultParameters:
client_trace_id: Client-generated GUID for request trackingscope: Comma-separated list filtering results ("translation", "transliteration", "dictionary")accept_language: BCP 47 language tag for localized language namesetag: Resource version for caching supportmatch_condition: Conditional request behaviorReturns: Complete language support information organized by operation type
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")class GetSupportedLanguagesResult(dict):
translation: Optional[Dict[str, TranslationLanguage]]
transliteration: Optional[Dict[str, TransliterationLanguage]]
dictionary: Optional[Dict[str, SourceDictionaryLanguage]]class TranslationLanguage:
name: str # Display name in requested locale
native_name: str # Native language name
dir: LanguageDirectionality # Text directionality (ltr/rtl)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 directionalityclass 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 directionalityclass 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