Text translation v2 ga (#46435)

* v2 init

* update version & docs

* update test setup to reuse preview endpoints

* Fix Entra ID validation: resource_id required, region optional

* fix pylint & pyright CI checks

* feedback applied: + IO[bytes] overloads; hide internal models

Co-authored-by: Copilot <copilot@github.com>

---------

Co-authored-by: Jiarui Guo <jiarguo@microsoft.com>
Co-authored-by: Copilot <copilot@github.com>

Author: 3 people

sdk/translation/azure-ai-translation-text/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Release History
 
+## 2.0.0 (2026-06-06)
+
+### Features Added
+
+- GA release of Azure AI Translator Text Translation SDK version 2.0.0.
+- Updated to stable API version 2026-06-06.
+- Added `TranslationTone` and `TranslationGender` enums for type-safe tone and gender options.
+
+### Breaking Changes
+
+- Removed `grade` parameter from translation options.
+
+### Other Changes
+
+- Simplified client constructor and internal authentication handling.
+
 ## 2.0.0b1 (2026-01-08)
 
 ### Features Added

sdk/translation/azure-ai-translation-text/_metadata.json

@@ -1,3 +1,6 @@
 {
-  "apiVersion": "2025-10-01-preview"
+  "apiVersion": "2026-06-06",
+  "apiVersions": {
+    "TextTranslation": "2026-06-06"
+  }
 }

sdk/translation/azure-ai-translation-text/apiview-properties.json

@@ -24,6 +24,8 @@
         "azure.ai.translation.text.models.TextType": "TextTranslation.TextType",
         "azure.ai.translation.text.models.ProfanityAction": "TextTranslation.ProfanityAction",
         "azure.ai.translation.text.models.ProfanityMarker": "TextTranslation.ProfanityMarker",
+        "azure.ai.translation.text.models.TranslationTone": "TextTranslation.TranslationTone",
+        "azure.ai.translation.text.models.TranslationGender": "TextTranslation.TranslationGender",
         "azure.ai.translation.text.TextTranslationClient.get_supported_languages": "TextTranslation.getSupportedLanguages",
         "azure.ai.translation.text.aio.TextTranslationClient.get_supported_languages": "TextTranslation.getSupportedLanguages",
         "azure.ai.translation.text.TextTranslationClient.translate": "TextTranslation.translate",

sdk/translation/azure-ai-translation-text/azure/ai/translation/text/_client.py

@@ -7,51 +7,46 @@
 # --------------------------------------------------------------------------
 
 from copy import deepcopy
-from typing import Any
+from typing import Any, Optional, TYPE_CHECKING, Union
 from typing_extensions import Self
 
 from azure.core import PipelineClient
+from azure.core.credentials import AzureKeyCredential
 from azure.core.pipeline import policies
 from azure.core.rest import HttpRequest, HttpResponse
 
 from ._configuration import TextTranslationClientConfiguration
 from ._operations import _TextTranslationClientOperationsMixin
 from ._utils.serialization import Deserializer, Serializer
 
+if TYPE_CHECKING:
+    from azure.core.credentials import TokenCredential
 
-class TextTranslationClient(_TextTranslationClientOperationsMixin):
-    """Text translation is a cloud-based REST API feature of the Translator service that uses neural
-    machine translation technology to enable quick and accurate source-to-target text translation
-    in real time across all supported languages.
-
-    The following methods are supported by the Text Translation feature:
-
-    Languages. Returns a list of languages supported by Translate, Transliterate, and Dictionary
-    Lookup operations.
 
-    Translate. Renders single source-language text to multiple target-language texts with a single
-    request.
-
-    Transliterate. Converts characters or letters of a source language to the corresponding
-    characters or letters of a target language.
-
-    Detect. Returns the source code language code and a boolean variable denoting whether the
-    detected language is supported for text translation and transliteration.
+class TextTranslationClient(_TextTranslationClientOperationsMixin):
+    """Azure Translator is a cloud-based, multilingual, neural machine translation service. The Text
+    Translation API enables robust and scalable translation capabilities suitable for diverse
+    applications.
 
     :param endpoint: Supported Text Translation endpoints (protocol and hostname, for example:
-         `https://api.cognitive.microsofttranslator.com
+     `https://api.cognitive.microsofttranslator.com
      <https://api.cognitive.microsofttranslator.com>`_). Required.
     :type endpoint: str
-    :keyword api_version: Mandatory API version parameter. Default value is "2025-10-01-preview".
-     Note that overriding this default value may result in unsupported behavior.
+    :param credential: Credential used to authenticate requests to the service. Is either a key
+     credential type or a token credential type. Default value is None.
+    :type credential: ~azure.core.credentials.AzureKeyCredential or
+     ~azure.core.credentials.TokenCredential
+    :keyword api_version: Mandatory API version parameter. Known values are "2026-06-06". Default
+     value is "2026-06-06". Note that overriding this default value may result in unsupported
+     behavior.
     :paramtype api_version: str
     """
 
-    def __init__(  # pylint: disable=missing-client-constructor-parameter-credential
-        self, endpoint: str, **kwargs: Any
+    def __init__(
+        self, endpoint: str, credential: Optional[Union[AzureKeyCredential, "TokenCredential"]] = None, **kwargs: Any
     ) -> None:
         _endpoint = "{Endpoint}"
-        self._config = TextTranslationClientConfiguration(endpoint=endpoint, **kwargs)
+        self._config = TextTranslationClientConfiguration(endpoint=endpoint, credential=credential, **kwargs)
 
         _policies = kwargs.pop("policies", None)
         if _policies is None:

sdk/translation/azure-ai-translation-text/azure/ai/translation/text/_configuration.py

@@ -6,12 +6,16 @@
 # Changes may cause incorrect behavior and will be lost if the code is regenerated.
 # --------------------------------------------------------------------------
 
-from typing import Any
+from typing import Any, Optional, TYPE_CHECKING, Union
 
+from azure.core.credentials import AzureKeyCredential
 from azure.core.pipeline import policies
 
 from ._version import VERSION
 
+if TYPE_CHECKING:
+    from azure.core.credentials import TokenCredential
+
 
 class TextTranslationClientConfiguration:  # pylint: disable=too-many-instance-attributes
     """Configuration for TextTranslationClient.
@@ -20,26 +24,42 @@ class TextTranslationClientConfiguration:  # pylint: disable=too-many-instance-a
     attributes.
 
     :param endpoint: Supported Text Translation endpoints (protocol and hostname, for example:
-         `https://api.cognitive.microsofttranslator.com
+     `https://api.cognitive.microsofttranslator.com
      <https://api.cognitive.microsofttranslator.com>`_). Required.
     :type endpoint: str
-    :keyword api_version: Mandatory API version parameter. Default value is "2025-10-01-preview".
-     Note that overriding this default value may result in unsupported behavior.
+    :param credential: Credential used to authenticate requests to the service. Is either a key
+     credential type or a token credential type. Default value is None.
+    :type credential: ~azure.core.credentials.AzureKeyCredential or
+     ~azure.core.credentials.TokenCredential
+    :keyword api_version: Mandatory API version parameter. Known values are "2026-06-06". Default
+     value is "2026-06-06". Note that overriding this default value may result in unsupported
+     behavior.
     :paramtype api_version: str
     """
 
-    def __init__(self, endpoint: str, **kwargs: Any) -> None:
-        api_version: str = kwargs.pop("api_version", "2025-10-01-preview")
+    def __init__(
+        self, endpoint: str, credential: Optional[Union[AzureKeyCredential, "TokenCredential"]] = None, **kwargs: Any
+    ) -> None:
+        api_version: str = kwargs.pop("api_version", "2026-06-06")
 
         if endpoint is None:
             raise ValueError("Parameter 'endpoint' must not be None.")
 
         self.endpoint = endpoint
+        self.credential = credential
         self.api_version = api_version
+        self.credential_scopes = kwargs.pop("credential_scopes", ["https://cognitiveservices.azure.com/.default"])
         kwargs.setdefault("sdk_moniker", "ai-translation-text/{}".format(VERSION))
         self.polling_interval = kwargs.get("polling_interval", 30)
         self._configure(**kwargs)
 
+    def _infer_policy(self, **kwargs):
+        if isinstance(self.credential, AzureKeyCredential):
+            return policies.AzureKeyCredentialPolicy(self.credential, "Ocp-Apim-Subscription-Key", **kwargs)
+        if hasattr(self.credential, "get_token"):
+            return policies.BearerTokenCredentialPolicy(self.credential, *self.credential_scopes, **kwargs)
+        raise TypeError(f"Unsupported credential: {self.credential}")
+
     def _configure(self, **kwargs: Any) -> None:
         self.user_agent_policy = kwargs.get("user_agent_policy") or policies.UserAgentPolicy(**kwargs)
         self.headers_policy = kwargs.get("headers_policy") or policies.HeadersPolicy(**kwargs)
@@ -50,3 +70,5 @@ def _configure(self, **kwargs: Any) -> None:
         self.redirect_policy = kwargs.get("redirect_policy") or policies.RedirectPolicy(**kwargs)
         self.retry_policy = kwargs.get("retry_policy") or policies.RetryPolicy(**kwargs)
         self.authentication_policy = kwargs.get("authentication_policy")
+        if self.credential and not self.authentication_policy:
+            self.authentication_policy = self._infer_policy(**kwargs)

sdk/translation/azure-ai-translation-text/azure/ai/translation/text/_model_base.py

@@ -687,6 +687,7 @@ def _get_deserialize_callable_from_annotation(  # pylint: disable=R0911, R0915,
 
     # is it optional?
     try:
+        # pylint: disable=unidiomatic-typecheck
         if any(a for a in annotation.__args__ if a == type(None)):  # pyright: ignore
             if len(annotation.__args__) <= 2:  # pyright: ignore
                 if_obj_deserializer = _get_deserialize_callable_from_annotation(
@@ -697,6 +698,7 @@ def _get_deserialize_callable_from_annotation(  # pylint: disable=R0911, R0915,
             # the type is Optional[Union[...]], we need to remove the None type from the Union
             annotation_copy = copy.copy(annotation)
             annotation_copy.__args__ = [a for a in annotation_copy.__args__ if a != type(None)]  # pyright: ignore
+            # pylint: enable=unidiomatic-typecheck
             return _get_deserialize_callable_from_annotation(annotation_copy, module, rf)
     except AttributeError:
         pass

sdk/translation/azure-ai-translation-text/azure/ai/translation/text/_operations/_operations.py

@@ -54,7 +54,7 @@ def build_text_translation_get_supported_languages_request(  # pylint: disable=n
     _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {})
     _params = case_insensitive_dict(kwargs.pop("params", {}) or {})
 
-    api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2025-10-01-preview"))
+    api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2026-06-06"))
     accept = _headers.pop("Accept", "application/json")
 
     # Construct URL
@@ -86,7 +86,7 @@ def build_text_translation_translate_request(*, client_trace_id: Optional[str] =
     _params = case_insensitive_dict(kwargs.pop("params", {}) or {})
 
     content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None))
-    api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2025-10-01-preview"))
+    api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2026-06-06"))
     accept = _headers.pop("Accept", "application/json")
 
     # Construct URL
@@ -112,7 +112,7 @@ def build_text_translation_transliterate_request(  # pylint: disable=name-too-lo
     _params = case_insensitive_dict(kwargs.pop("params", {}) or {})
 
     content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None))
-    api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2025-10-01-preview"))
+    api_version: str = kwargs.pop("api_version", _params.pop("api-version", "2026-06-06"))
     accept = _headers.pop("Accept", "application/json")
 
     # Construct URL
@@ -218,6 +218,7 @@ def get_supported_languages(
         }
         _request.url = self._client.format_url(_request.url, **path_format_arguments)
 
+        _decompress = kwargs.pop("decompress", True)
         _stream = kwargs.pop("stream", False)
         pipeline_response: PipelineResponse = self._client._pipeline.run(  # pylint: disable=protected-access
             _request, stream=_stream, **kwargs
@@ -243,7 +244,7 @@ def get_supported_languages(
         response_headers["ETag"] = self._deserialize("str", response.headers.get("ETag"))
 
         if _stream:
-            deserialized = response.iter_bytes()
+            deserialized = response.iter_bytes() if _decompress else response.iter_raw()
         else:
             deserialized = _deserialize(_models.GetSupportedLanguagesResult, response.json())
 
@@ -334,7 +335,7 @@ def translate(
     @api_version_validation(
         method_added_on="2025-10-01-preview",
         params_added_on={"2025-10-01-preview": ["client_trace_id", "api_version", "content_type", "accept"]},
-        api_versions_list=["2025-10-01-preview"],
+        api_versions_list=["2025-10-01-preview", "2026-06-06"],
     )
     def translate(
         self,
@@ -391,6 +392,7 @@ def translate(
         }
         _request.url = self._client.format_url(_request.url, **path_format_arguments)
 
+        _decompress = kwargs.pop("decompress", True)
         _stream = kwargs.pop("stream", False)
         pipeline_response: PipelineResponse = self._client._pipeline.run(  # pylint: disable=protected-access
             _request, stream=_stream, **kwargs
@@ -417,7 +419,7 @@ def translate(
         response_headers["x-metered-usage"] = self._deserialize("int", response.headers.get("x-metered-usage"))
 
         if _stream:
-            deserialized = response.iter_bytes()
+            deserialized = response.iter_bytes() if _decompress else response.iter_raw()
         else:
             deserialized = _deserialize(_models.TranslationResult, response.json())
 
@@ -563,7 +565,7 @@ def transliterate(
                 "accept",
             ]
         },
-        api_versions_list=["2025-10-01-preview"],
+        api_versions_list=["2025-10-01-preview", "2026-06-06"],
     )
     def transliterate(
         self,
@@ -638,6 +640,7 @@ def transliterate(
         }
         _request.url = self._client.format_url(_request.url, **path_format_arguments)
 
+        _decompress = kwargs.pop("decompress", True)
         _stream = kwargs.pop("stream", False)
         pipeline_response: PipelineResponse = self._client._pipeline.run(  # pylint: disable=protected-access
             _request, stream=_stream, **kwargs
@@ -662,7 +665,7 @@ def transliterate(
         response_headers["X-RequestId"] = self._deserialize("str", response.headers.get("X-RequestId"))
 
         if _stream:
-            deserialized = response.iter_bytes()
+            deserialized = response.iter_bytes() if _decompress else response.iter_raw()
         else:
             deserialized = _deserialize(_models.TransliterateResult, response.json())
 

sdk/translation/azure-ai-translation-text/azure/ai/translation/text/_operations/_patch.py

@@ -28,7 +28,9 @@ class _TextTranslationClientOperationsMixin(
 ):
     """Mixin class that delegates to the generated operations class while providing custom method signatures."""
 
-    def _get_generated_operations(self) -> _TextTranslationClientOperationsMixinGenerated:  # pylint: disable=protected-access
+    def _get_generated_operations(
+        self,
+    ) -> _TextTranslationClientOperationsMixinGenerated:  # pylint: disable=protected-access
         """Get an instance of the generated operations mixin.
 
         This creates a wrapper object that shares the same _client, _config, _serialize, and _deserialize
@@ -191,6 +193,32 @@ def translate(
         :raises ~azure.core.exceptions.HttpResponseError:
         """
 
+    @overload  # type: ignore[override]
+    def translate(
+        self,
+        body: IO[bytes],
+        *,
+        client_trace_id: Optional[str] = None,
+        content_type: str = "application/json",
+        **kwargs: Any
+    ) -> List[_models.TranslatedTextItem]:
+        """Translate text.
+
+        Translates text using a raw bytes stream as the request body.
+
+        :param body: The request body as a file-like stream of bytes. Required.
+        :type body: IO[bytes]
+        :keyword client_trace_id: A client-generated GUID to uniquely identify the request. Default
+         value is None.
+        :paramtype client_trace_id: str
+        :keyword content_type: Body Parameter content-type. Content type parameter for JSON body.
+         Default value is "application/json".
+        :paramtype content_type: str
+        :return: list of TranslatedTextItem
+        :rtype: list[~azure.ai.translation.text.models.TranslatedTextItem]
+        :raises ~azure.core.exceptions.HttpResponseError:
+        """
+
     def translate(  # pyright: ignore[reportIncompatibleMethodOverride]
         self,
         body: Union[List[str], List[_models.TranslateInputItem], JSON, IO[bytes]],
@@ -352,6 +380,47 @@ def transliterate(
         :raises ~azure.core.exceptions.HttpResponseError:
         """
 
+    @overload  # type: ignore[override]
+    def transliterate(
+        self,
+        body: IO[bytes],
+        *,
+        language: str,
+        from_script: str,
+        to_script: str,
+        client_trace_id: Optional[str] = None,
+        content_type: str = "application/json",
+        **kwargs: Any
+    ) -> List[_models.TransliteratedText]:
+        """Transliterate Text.
+
+        Transliterates text using a raw bytes stream as the request body.
+
+        :param body: The request body as a file-like stream of bytes. Required.
+        :type body: IO[bytes]
+        :keyword language: Specifies the language of the text to convert from one script to another.
+         Possible languages are listed in the transliteration scope obtained by querying the service
+         for its supported languages. Required.
+        :paramtype language: str
+        :keyword from_script: Specifies the script used by the input text. Look up supported languages
+         using the transliteration scope,
+         to find input scripts available for the selected language. Required.
+        :paramtype from_script: str
+        :keyword to_script: Specifies the output script. Look up supported languages using the
+         transliteration scope, to find output
+         scripts available for the selected combination of input language and input script. Required.
+        :paramtype to_script: str
+        :keyword client_trace_id: A client-generated GUID to uniquely identify the request. Default
+         value is None.
+        :paramtype client_trace_id: str
+        :keyword content_type: Body Parameter content-type. Content type parameter for JSON body.
+         Default value is "application/json".
+        :paramtype content_type: str
+        :return: list of TransliteratedText
+        :rtype: list[~azure.ai.translation.text.models.TransliteratedText]
+        :raises ~azure.core.exceptions.HttpResponseError:
+        """
+
     def transliterate(  # pyright: ignore[reportIncompatibleMethodOverride]
         self,
         body: Union[List[str], List[_models.InputTextItem], JSON, IO[bytes]],