azure-ai-transcription 1.0.0b2__py3-none-any.whl → 1.0.0b3__py3-none-any.whl

azure/ai/transcription/_client.py

@@ -27,7 +27,7 @@ class TranscriptionClient(_TranscriptionClientOperationsMixin):
     """TranscriptionClient.
 
     :param endpoint: Supported Cognitive Services endpoints (protocol and hostname, for example:
-     `https://westus.api.cognitive.microsoft.com <https://westus.api.cognitive.microsoft.com>`_.
+     `https://westus.api.cognitive.microsoft.com <https://westus.api.cognitive.microsoft.com>`_).
      Required.
     :type endpoint: str
     :param credential: Credential used to authenticate requests to the service. Is either a key

azure/ai/transcription/_configuration.py

@@ -24,7 +24,7 @@ class TranscriptionClientConfiguration:  # pylint: disable=too-many-instance-att
     attributes.
 
     :param endpoint: Supported Cognitive Services endpoints (protocol and hostname, for example:
-     `https://westus.api.cognitive.microsoft.com <https://westus.api.cognitive.microsoft.com>`_.
+     `https://westus.api.cognitive.microsoft.com <https://westus.api.cognitive.microsoft.com>`_).
      Required.
     :type endpoint: str
     :param credential: Credential used to authenticate requests to the service. Is either a key

azure/ai/transcription/_operations/_operations.py

@@ -110,12 +110,11 @@ class _TranscriptionClientOperationsMixin(
         _body = body.as_dict() if isinstance(body, _Model) else body
         _file_fields: list[str] = ["audio"]
         _data_fields: list[str] = ["definition"]
-        _files, _data = prepare_multipart_form_data(_body, _file_fields, _data_fields)
+        _files = prepare_multipart_form_data(_body, _file_fields, _data_fields)
 
         _request = build_transcription_transcribe_request(
             api_version=self._config.api_version,
             files=_files,
-            data=_data,
             headers=_headers,
             params=_params,
         )

azure/ai/transcription/_operations/_patch.py

@@ -12,7 +12,14 @@ from collections.abc import MutableMapping
 from typing import Any, Optional
 import json
 from azure.core.tracing.decorator import distributed_trace
-from azure.core.exceptions import map_error, HttpResponseError, ClientAuthenticationError, ResourceNotFoundError, ResourceExistsError, ResourceNotModifiedError
+from azure.core.exceptions import (
+    map_error,
+    HttpResponseError,
+    ClientAuthenticationError,
+    ResourceNotFoundError,
+    ResourceExistsError,
+    ResourceNotModifiedError,
+)
 
 from .. import models as _models
 from .._utils.model_base import _deserialize, SdkJSONEncoder
@@ -93,7 +100,9 @@ class _TranscriptionClientOperationsMixin(_TranscriptionClientOperationsMixinGen
         }
         _request.url = self._client.format_url(_request.url, **path_format_arguments)
 
-        pipeline_response = self._client._pipeline.run(_request, stream=False, **kwargs)  # pylint: disable=protected-access
+        pipeline_response = self._client._pipeline.run(  # pylint: disable=protected-access
+            _request, stream=False, **kwargs
+        )
         response = pipeline_response.http_response
 
         if response.status_code not in [200]:

azure/ai/transcription/_utils/model_base.py

@@ -37,6 +37,7 @@ __all__ = ["SdkJSONEncoder", "Model", "rest_field", "rest_discriminator"]
 
 TZ_UTC = timezone.utc
 _T = typing.TypeVar("_T")
+_NONE_TYPE = type(None)
 
 
 def _timedelta_as_isostr(td: timedelta) -> str:
@@ -171,6 +172,21 @@ _VALID_RFC7231 = re.compile(
     r"(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)\s\d{4}\s\d{2}:\d{2}:\d{2}\sGMT"
 )
 
+_ARRAY_ENCODE_MAPPING = {
+    "pipeDelimited": "|",
+    "spaceDelimited": " ",
+    "commaDelimited": ",",
+    "newlineDelimited": "\n",
+}
+
+
+def _deserialize_array_encoded(delimit: str, attr):
+    if isinstance(attr, str):
+        if attr == "":
+            return []
+        return attr.split(delimit)
+    return attr
+
 
 def _deserialize_datetime(attr: typing.Union[str, datetime]) -> datetime:
     """Deserialize ISO-8601 formatted string into Datetime object.
@@ -202,7 +218,7 @@ def _deserialize_datetime(attr: typing.Union[str, datetime]) -> datetime:
     test_utc = date_obj.utctimetuple()
     if test_utc.tm_year > 9999 or test_utc.tm_year < 1:
         raise OverflowError("Hit max or min date")
-    return date_obj
+    return date_obj  # type: ignore[no-any-return]
 
 
 def _deserialize_datetime_rfc7231(attr: typing.Union[str, datetime]) -> datetime:
@@ -256,7 +272,7 @@ def _deserialize_time(attr: typing.Union[str, time]) -> time:
     """
     if isinstance(attr, time):
         return attr
-    return isodate.parse_time(attr)
+    return isodate.parse_time(attr)  # type: ignore[no-any-return]
 
 
 def _deserialize_bytes(attr):
@@ -315,6 +331,8 @@ _DESERIALIZE_MAPPING_WITHFORMAT = {
 def get_deserializer(annotation: typing.Any, rf: typing.Optional["_RestField"] = None):
     if annotation is int and rf and rf._format == "str":
         return _deserialize_int_as_str
+    if annotation is str and rf and rf._format in _ARRAY_ENCODE_MAPPING:
+        return functools.partial(_deserialize_array_encoded, _ARRAY_ENCODE_MAPPING[rf._format])
     if rf and rf._format:
         return _DESERIALIZE_MAPPING_WITHFORMAT.get(rf._format)
     return _DESERIALIZE_MAPPING.get(annotation)  # pyright: ignore
@@ -353,9 +371,39 @@ class _MyMutableMapping(MutableMapping[str, typing.Any]):
         return key in self._data
 
     def __getitem__(self, key: str) -> typing.Any:
+        # If this key has been deserialized (for mutable types), we need to handle serialization
+        if hasattr(self, "_attr_to_rest_field"):
+            cache_attr = f"_deserialized_{key}"
+            if hasattr(self, cache_attr):
+                rf = _get_rest_field(getattr(self, "_attr_to_rest_field"), key)
+                if rf:
+                    value = self._data.get(key)
+                    if isinstance(value, (dict, list, set)):
+                        # For mutable types, serialize and return
+                        # But also update _data with serialized form and clear flag
+                        # so mutations via this returned value affect _data
+                        serialized = _serialize(value, rf._format)
+                        # If serialized form is same type (no transformation needed),
+                        # return _data directly so mutations work
+                        if isinstance(serialized, type(value)) and serialized == value:
+                            return self._data.get(key)
+                        # Otherwise return serialized copy and clear flag
+                        try:
+                            object.__delattr__(self, cache_attr)
+                        except AttributeError:
+                            pass
+                        # Store serialized form back
+                        self._data[key] = serialized
+                        return serialized
         return self._data.__getitem__(key)
 
     def __setitem__(self, key: str, value: typing.Any) -> None:
+        # Clear any cached deserialized value when setting through dictionary access
+        cache_attr = f"_deserialized_{key}"
+        try:
+            object.__delattr__(self, cache_attr)
+        except AttributeError:
+            pass
         self._data.__setitem__(key, value)
 
     def __delitem__(self, key: str) -> None:
@@ -483,6 +531,8 @@ def _is_model(obj: typing.Any) -> bool:
 
 def _serialize(o, format: typing.Optional[str] = None):  # pylint: disable=too-many-return-statements
     if isinstance(o, list):
+        if format in _ARRAY_ENCODE_MAPPING and all(isinstance(x, str) for x in o):
+            return _ARRAY_ENCODE_MAPPING[format].join(o)
         return [_serialize(x, format) for x in o]
     if isinstance(o, dict):
         return {k: _serialize(v, format) for k, v in o.items()}
@@ -758,6 +808,14 @@ def _deserialize_multiple_sequence(
     return type(obj)(_deserialize(deserializer, entry, module) for entry, deserializer in zip(obj, entry_deserializers))
 
 
+def _is_array_encoded_deserializer(deserializer: functools.partial) -> bool:
+    return (
+        isinstance(deserializer, functools.partial)
+        and isinstance(deserializer.args[0], functools.partial)
+        and deserializer.args[0].func == _deserialize_array_encoded  # pylint: disable=comparison-with-callable
+    )
+
+
 def _deserialize_sequence(
     deserializer: typing.Optional[typing.Callable],
     module: typing.Optional[str],
@@ -767,6 +825,19 @@ def _deserialize_sequence(
         return obj
     if isinstance(obj, ET.Element):
         obj = list(obj)
+
+    # encoded string may be deserialized to sequence
+    if isinstance(obj, str) and isinstance(deserializer, functools.partial):
+        # for list[str]
+        if _is_array_encoded_deserializer(deserializer):
+            return deserializer(obj)
+
+        # for list[Union[...]]
+        if isinstance(deserializer.args[0], list):
+            for sub_deserializer in deserializer.args[0]:
+                if _is_array_encoded_deserializer(sub_deserializer):
+                    return sub_deserializer(obj)
+
     return type(obj)(_deserialize(deserializer, entry, module) for entry in obj)
 
 
@@ -817,16 +888,16 @@ def _get_deserialize_callable_from_annotation(  # pylint: disable=too-many-retur
 
     # is it optional?
     try:
-        if any(a for a in annotation.__args__ if a == type(None)):  # pyright: ignore
+        if any(a is _NONE_TYPE for a in annotation.__args__):  # pyright: ignore
             if len(annotation.__args__) <= 2:  # pyright: ignore
                 if_obj_deserializer = _get_deserialize_callable_from_annotation(
-                    next(a for a in annotation.__args__ if a != type(None)), module, rf  # pyright: ignore
+                    next(a for a in annotation.__args__ if a is not _NONE_TYPE), module, rf  # pyright: ignore
                 )
 
                 return functools.partial(_deserialize_with_optional, if_obj_deserializer)
             # 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
+            annotation_copy.__args__ = [a for a in annotation_copy.__args__ if a is not _NONE_TYPE]  # pyright: ignore
             return _get_deserialize_callable_from_annotation(annotation_copy, module, rf)
     except AttributeError:
         pass
@@ -952,7 +1023,7 @@ def _failsafe_deserialize(
 ) -> typing.Any:
     try:
         return _deserialize(deserializer, response.json(), module, rf, format)
-    except DeserializationError:
+    except Exception:  # pylint: disable=broad-except
         _LOGGER.warning(
             "Ran into a deserialization error. Ignoring since this is failsafe deserialization", exc_info=True
         )
@@ -965,7 +1036,7 @@ def _failsafe_deserialize_xml(
 ) -> typing.Any:
     try:
         return _deserialize_xml(deserializer, response.text())
-    except DeserializationError:
+    except Exception:  # pylint: disable=broad-except
         _LOGGER.warning(
             "Ran into a deserialization error. Ignoring since this is failsafe deserialization", exc_info=True
         )
@@ -998,7 +1069,11 @@ class _RestField:
 
     @property
     def _class_type(self) -> typing.Any:
-        return getattr(self._type, "args", [None])[0]
+        result = getattr(self._type, "args", [None])[0]
+        # type may be wrapped by nested functools.partial so we need to check for that
+        if isinstance(result, functools.partial):
+            return getattr(result, "args", [None])[0]
+        return result
 
     @property
     def _rest_name(self) -> str:
@@ -1009,14 +1084,37 @@ class _RestField:
     def __get__(self, obj: Model, type=None):  # pylint: disable=redefined-builtin
         # by this point, type and rest_name will have a value bc we default
         # them in __new__ of the Model class
-        item = obj.get(self._rest_name)
+        # Use _data.get() directly to avoid triggering __getitem__ which clears the cache
+        item = obj._data.get(self._rest_name)
         if item is None:
             return item
         if self._is_model:
             return item
-        return _deserialize(self._type, _serialize(item, self._format), rf=self)
+
+        # For mutable types, we want mutations to directly affect _data
+        # Check if we've already deserialized this value
+        cache_attr = f"_deserialized_{self._rest_name}"
+        if hasattr(obj, cache_attr):
+            # Return the value from _data directly (it's been deserialized in place)
+            return obj._data.get(self._rest_name)
+
+        deserialized = _deserialize(self._type, _serialize(item, self._format), rf=self)
+
+        # For mutable types, store the deserialized value back in _data
+        # so mutations directly affect _data
+        if isinstance(deserialized, (dict, list, set)):
+            obj._data[self._rest_name] = deserialized
+            object.__setattr__(obj, cache_attr, True)  # Mark as deserialized
+            return deserialized
+
+        return deserialized
 
     def __set__(self, obj: Model, value) -> None:
+        # Clear the cached deserialized object when setting a new value
+        cache_attr = f"_deserialized_{self._rest_name}"
+        if hasattr(obj, cache_attr):
+            object.__delattr__(obj, cache_attr)
+
         if value is None:
             # we want to wipe out entries if users set attr to None
             try:
@@ -1184,7 +1282,7 @@ def _get_wrapped_element(
         _get_element(v, exclude_readonly, meta, wrapped_element)
     else:
         wrapped_element.text = _get_primitive_type_value(v)
-    return wrapped_element
+    return wrapped_element  # type: ignore[no-any-return]
 
 
 def _get_primitive_type_value(v) -> str:
@@ -1197,7 +1295,9 @@ def _get_primitive_type_value(v) -> str:
     return str(v)
 
 
-def _create_xml_element(tag, prefix=None, ns=None):
+def _create_xml_element(
+    tag: typing.Any, prefix: typing.Optional[str] = None, ns: typing.Optional[str] = None
+) -> ET.Element:
     if prefix and ns:
         ET.register_namespace(prefix, ns)
     if ns:

azure/ai/transcription/_utils/serialization.py

@@ -821,13 +821,20 @@ class Serializer:  # pylint: disable=too-many-public-methods
         :param str data_type: Type of object in the iterable.
         :rtype: str, int, float, bool
         :return: serialized object
+        :raises TypeError: raise if data_type is not one of str, int, float, bool.
         """
         custom_serializer = cls._get_custom_serializers(data_type, **kwargs)
         if custom_serializer:
             return custom_serializer(data)
         if data_type == "str":
             return cls.serialize_unicode(data)
-        return eval(data_type)(data)  # nosec # pylint: disable=eval-used
+        if data_type == "int":
+            return int(data)
+        if data_type == "float":
+            return float(data)
+        if data_type == "bool":
+            return bool(data)
+        raise TypeError("Unknown basic data type: {}".format(data_type))
 
     @classmethod
     def serialize_unicode(cls, data):
@@ -1757,7 +1764,7 @@ class Deserializer:
         :param str data_type: deserialization data type.
         :return: Deserialized basic type.
         :rtype: str, int, float or bool
-        :raises TypeError: if string format is not valid.
+        :raises TypeError: if string format is not valid or data_type is not one of str, int, float, bool.
         """
         # If we're here, data is supposed to be a basic type.
         # If it's still an XML node, take the text
@@ -1783,7 +1790,11 @@ class Deserializer:
 
         if data_type == "str":
             return self.deserialize_unicode(attr)
-        return eval(data_type)(attr)  # nosec # pylint: disable=eval-used
+        if data_type == "int":
+            return int(attr)
+        if data_type == "float":
+            return float(attr)
+        raise TypeError("Unknown basic data type: {}".format(data_type))
 
     @staticmethod
     def deserialize_unicode(data):

azure/ai/transcription/_utils/utils.py

@@ -49,9 +49,8 @@ def serialize_multipart_data_entry(data_entry: Any) -> Any:
 
 def prepare_multipart_form_data(
     body: Mapping[str, Any], multipart_fields: list[str], data_fields: list[str]
-) -> tuple[list[FileType], dict[str, Any]]:
+) -> list[FileType]:
     files: list[FileType] = []
-    data: dict[str, Any] = {}
     for multipart_field in multipart_fields:
         multipart_entry = body.get(multipart_field)
         if isinstance(multipart_entry, list):
@@ -59,9 +58,11 @@ def prepare_multipart_form_data(
         elif multipart_entry:
             files.append((multipart_field, multipart_entry))
 
+    # if files is empty, sdk core library can't handle multipart/form-data correctly, so
+    # we put data fields into files with filename as None to avoid that scenario.
     for data_field in data_fields:
         data_entry = body.get(data_field)
         if data_entry:
-            data[data_field] = serialize_multipart_data_entry(data_entry)
+            files.append((data_field, str(serialize_multipart_data_entry(data_entry))))
 
-    return files, data
+    return files

azure/ai/transcription/_version.py

@@ -6,4 +6,4 @@
 # Changes may cause incorrect behavior and will be lost if the code is regenerated.
 # --------------------------------------------------------------------------
 
-VERSION = "1.0.0b2"
+VERSION = "1.0.0b3"

azure/ai/transcription/aio/_client.py

@@ -27,7 +27,7 @@ class TranscriptionClient(_TranscriptionClientOperationsMixin):
     """TranscriptionClient.
 
     :param endpoint: Supported Cognitive Services endpoints (protocol and hostname, for example:
-     `https://westus.api.cognitive.microsoft.com <https://westus.api.cognitive.microsoft.com>`_.
+     `https://westus.api.cognitive.microsoft.com <https://westus.api.cognitive.microsoft.com>`_).
      Required.
     :type endpoint: str
     :param credential: Credential used to authenticate requests to the service. Is either a key

azure/ai/transcription/aio/_configuration.py

@@ -24,7 +24,7 @@ class TranscriptionClientConfiguration:  # pylint: disable=too-many-instance-att
     attributes.
 
     :param endpoint: Supported Cognitive Services endpoints (protocol and hostname, for example:
-     `https://westus.api.cognitive.microsoft.com <https://westus.api.cognitive.microsoft.com>`_.
+     `https://westus.api.cognitive.microsoft.com <https://westus.api.cognitive.microsoft.com>`_).
      Required.
     :type endpoint: str
     :param credential: Credential used to authenticate requests to the service. Is either a key

azure/ai/transcription/aio/_operations/_operations.py

@@ -90,12 +90,11 @@ class _TranscriptionClientOperationsMixin(
         _body = body.as_dict() if isinstance(body, _Model) else body
         _file_fields: list[str] = ["audio"]
         _data_fields: list[str] = ["definition"]
-        _files, _data = prepare_multipart_form_data(_body, _file_fields, _data_fields)
+        _files = prepare_multipart_form_data(_body, _file_fields, _data_fields)
 
         _request = build_transcription_transcribe_request(
             api_version=self._config.api_version,
             files=_files,
-            data=_data,
             headers=_headers,
             params=_params,
         )

azure/ai/transcription/aio/_operations/_patch.py

@@ -12,7 +12,14 @@ from collections.abc import MutableMapping
 from typing import Any, Optional
 import json
 from azure.core.tracing.decorator_async import distributed_trace_async
-from azure.core.exceptions import map_error, HttpResponseError, ClientAuthenticationError, ResourceNotFoundError, ResourceExistsError, ResourceNotModifiedError
+from azure.core.exceptions import (
+    map_error,
+    HttpResponseError,
+    ClientAuthenticationError,
+    ResourceNotFoundError,
+    ResourceExistsError,
+    ResourceNotModifiedError,
+)
 
 from ... import models as _models
 from ..._utils.model_base import _deserialize, SdkJSONEncoder
@@ -91,7 +98,9 @@ class _TranscriptionClientOperationsMixin(_TranscriptionClientOperationsMixinGen
         }
         _request.url = self._client.format_url(_request.url, **path_format_arguments)
 
-        pipeline_response = await self._client._pipeline.run(_request, stream=False, **kwargs)  # pylint: disable=protected-access
+        pipeline_response = await self._client._pipeline.run(  # pylint: disable=protected-access
+            _request, stream=False, **kwargs
+        )
         response = pipeline_response.http_response
 
         if response.status_code not in [200]:

azure/ai/transcription/models/_enums.py

@@ -18,6 +18,6 @@ class ProfanityFilterMode(str, Enum, metaclass=CaseInsensitiveEnumMeta):
     REMOVED = "Removed"
     """Remove profanity."""
     TAGS = "Tags"
-    """Add "profanity" XML tags</Profanity>"""
+    """Add "profanity" XML tags</Profanity>."""
     MASKED = "Masked"
-    """Mask the profanity with * except of the first letter, e.g., f***"""
+    """Mask the profanity with * except of the first letter, e.g., f***."""

azure/ai/transcription/models/_models.py

@@ -100,7 +100,7 @@ class PhraseListProperties(_Model):
 
     :ivar phrases: List of phrases for recognition.
     :vartype phrases: list[str]
-    :ivar biasing_weight: Biasing weight for phrase list (1.0 to 20.0).
+    :ivar biasing_weight: Biasing weight for phrase list (0.0-2.0).
     :vartype biasing_weight: float
     """
 
@@ -109,7 +109,7 @@ class PhraseListProperties(_Model):
     biasing_weight: Optional[float] = rest_field(
         name="biasingWeight", visibility=["read", "create", "update", "delete", "query"]
     )
-    """Biasing weight for phrase list (1.0 to 20.0)."""
+    """Biasing weight for phrase list (0.0-2.0)."""
 
     @overload
     def __init__(

azure/ai/transcription/models/_patch.py

@@ -7,9 +7,54 @@
 
 Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize
 """
+from typing import Any, Optional
 
+from ._models import EnhancedModeProperties as _EnhancedModeProperties
 
-__all__: list[str] = []  # Add all objects you want publicly available to users at this package level
+
+class EnhancedModeProperties(_EnhancedModeProperties):
+    """Enhanced mode properties for transcription.
+
+    :ivar task: Task type for enhanced mode.
+    :vartype task: str
+    :ivar target_language: Target language for enhanced mode.
+    :vartype target_language: str
+    :ivar prompt: A list of user prompts.
+    :vartype prompt: list[str]
+    """
+
+    def __init__(
+        self,
+        *,
+        task: Optional[str] = None,
+        target_language: Optional[str] = None,
+        prompt: Optional[list[str]] = None,
+        **kwargs: Any,
+    ) -> None:
+        super().__init__(task=task, target_language=target_language, prompt=prompt, **kwargs)
+        # Automatically set enabled=True if any enhanced mode properties are specified
+        # This is hidden from public API but sent to the server
+        self._enabled: Optional[bool] = None
+        if task is not None or target_language is not None or prompt is not None:
+            self._enabled = True
+
+    def as_dict(self, *, exclude_readonly: bool = False) -> dict[str, Any]:
+        """Return a dict that can be turned into json using json.dump.
+
+        :keyword bool exclude_readonly: Whether to remove the readonly properties.
+        :returns: A dict JSON compatible object
+        :rtype: dict
+        """
+        result = super().as_dict(exclude_readonly=exclude_readonly)
+        # Always include enabled in the request if it's set
+        if self._enabled is not None:
+            result["enabled"] = self._enabled
+        return result
+
+
+__all__: list[str] = [
+    "EnhancedModeProperties"
+]  # Add all objects you want publicly available to users at this package level
 
 
 def patch_sdk():

{azure_ai_transcription-1.0.0b2.dist-info → azure_ai_transcription-1.0.0b3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: azure-ai-transcription
-Version: 1.0.0b2
+Version: 1.0.0b3
 Summary: Microsoft Corporation Azure AI Transcription Client Library for Python
 Author-email: Microsoft Corporation <azpysdkhelp@microsoft.com>
 License-Expression: MIT
@@ -19,7 +19,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: isodate>=0.6.1
-Requires-Dist: azure-core>=1.35.0
+Requires-Dist: azure-core>=1.37.0
 Requires-Dist: typing-extensions>=4.6.0
 Dynamic: license-file
 
@@ -174,10 +174,18 @@ from azure.ai.transcription.models import TranscriptionContent, TranscriptionOpt
 
 # Get configuration from environment variables
 endpoint = os.environ["AZURE_SPEECH_ENDPOINT"]
-api_key = os.environ["AZURE_SPEECH_API_KEY"]
+
+# We recommend using role-based access control (RBAC) for production scenarios
+api_key = os.environ.get("AZURE_SPEECH_API_KEY")
+if api_key:
+    credential = AzureKeyCredential(api_key)
+else:
+    from azure.identity import DefaultAzureCredential
+
+    credential = DefaultAzureCredential()
 
 # Create the transcription client
-client = TranscriptionClient(endpoint=endpoint, credential=AzureKeyCredential(api_key))
+client = TranscriptionClient(endpoint=endpoint, credential=credential)
 
 # Path to your audio file
 import pathlib
@@ -222,10 +230,18 @@ from azure.ai.transcription.models import TranscriptionOptions
 
 # Get configuration from environment variables
 endpoint = os.environ["AZURE_SPEECH_ENDPOINT"]
-api_key = os.environ["AZURE_SPEECH_API_KEY"]
+
+# We recommend using role-based access control (RBAC) for production scenarios
+api_key = os.environ.get("AZURE_SPEECH_API_KEY")
+if api_key:
+    credential = AzureKeyCredential(api_key)
+else:
+    from azure.identity import DefaultAzureCredential
+
+    credential = DefaultAzureCredential()
 
 # Create the transcription client
-client = TranscriptionClient(endpoint=endpoint, credential=AzureKeyCredential(api_key))
+client = TranscriptionClient(endpoint=endpoint, credential=credential)
 
 # URL to your audio file (must be publicly accessible)
 audio_url = "https://example.com/path/to/audio.wav"
@@ -263,31 +279,29 @@ from azure.ai.transcription.models import (
 
 # Get configuration from environment variables
 endpoint = os.environ["AZURE_SPEECH_ENDPOINT"]
-api_key = os.environ["AZURE_SPEECH_API_KEY"]
+
+# We recommend using role-based access control (RBAC) for production scenarios
+api_key = os.environ.get("AZURE_SPEECH_API_KEY")
+if api_key:
+    credential = AzureKeyCredential(api_key)
+else:
+    from azure.identity import DefaultAzureCredential
+
+    credential = DefaultAzureCredential()
 
 # Create the transcription client
-client = TranscriptionClient(endpoint=endpoint, credential=AzureKeyCredential(api_key))
+client = TranscriptionClient(endpoint=endpoint, credential=credential)
 
 # Path to your audio file
-import pathlib
-
 audio_file_path = pathlib.Path(__file__).parent / "assets" / "audio.wav"
 
 # Open and read the audio file
 with open(audio_file_path, "rb") as audio_file:
-    # Create enhanced mode properties
-    # Enable enhanced mode for advanced processing capabilities
-    enhanced_mode = EnhancedModeProperties(
-        task="translation",  # Specify the task type (e.g., "translation", "summarization")
-        target_language="es-ES",  # Target language for translation
-        prompt=[
-            "Translate the following audio to Spanish",
-            "Focus on technical terminology",
-        ],  # Optional prompts to guide the enhanced mode
-    )
+    # Enhanced mode is automatically enabled when task is specified
+    enhanced_mode = EnhancedModeProperties(task="transcribe")
 
     # Create transcription options with enhanced mode
-    options = TranscriptionOptions(locales=["en-US"], enhanced_mode=enhanced_mode)
+    options = TranscriptionOptions(enhanced_mode=enhanced_mode)
 
     # Create the request content
     request_content = TranscriptionContent(definition=options, audio=audio_file)
@@ -296,14 +310,7 @@ with open(audio_file_path, "rb") as audio_file:
     result = client.transcribe(request_content)
 
     # Print the transcription result
-    print("Transcription with enhanced mode:")
-    print(f"{result.combined_phrases[0].text}")
-
-    # Print individual phrases if available
-    if result.phrases:
-        print("\nDetailed phrases:")
-        for phrase in result.phrases:
-            print(f"  [{phrase.offset_milliseconds}ms]: {phrase.text}")
+    print(result.combined_phrases[0].text)
 ```
 
 <!-- END SNIPPET -->
@@ -321,10 +328,18 @@ from azure.ai.transcription.models import TranscriptionContent, TranscriptionOpt
 
 # Get configuration from environment variables
 endpoint = os.environ["AZURE_SPEECH_ENDPOINT"]
-api_key = os.environ["AZURE_SPEECH_API_KEY"]
+
+# We recommend using role-based access control (RBAC) for production scenarios
+api_key = os.environ.get("AZURE_SPEECH_API_KEY")
+if api_key:
+    credential = AzureKeyCredential(api_key)
+else:
+    from azure.identity.aio import DefaultAzureCredential
+
+    credential = DefaultAzureCredential()
 
 # Create the transcription client
-async with TranscriptionClient(endpoint=endpoint, credential=AzureKeyCredential(api_key)) as client:
+async with TranscriptionClient(endpoint=endpoint, credential=credential) as client:
     # Path to your audio file
     import pathlib
 
@@ -464,6 +479,16 @@ This project has adopted the [Microsoft Open Source Code of Conduct][code_of_con
 
 # Release History
 
+## 1.0.0b3 (2026-02-04)
+
+### Features Added
+
+- Enhanced Mode now automatically sets `enabled=True` when `task`, `target_language`, or `prompt` are specified
+
+### Bugs Fixed
+
+- Fixed Enhanced Mode not being activated when using `EnhancedModeProperties` without explicitly setting `enabled=True`
+
 ## 1.0.0b2 (2025-12-19)
 
 ### Bugs Fixed

azure_ai_transcription-1.0.0b3.dist-info/RECORD

@@ -0,0 +1,29 @@
+azure/ai/transcription/__init__.py,sha256=EeG1egQNXEo3TvGAR2l71hUVkL7pKO_TQV0HTvIEB58,1034
+azure/ai/transcription/_client.py,sha256=4DixcxqIi4i12b-dePWmvmtmS5ynLvj0BK1LAKWjYuc,4732
+azure/ai/transcription/_configuration.py,sha256=zXCfZAJkZRDmeeipDnLBpNuEHzZg_9TYQGej2YYcmiU,3957
+azure/ai/transcription/_patch.py,sha256=bRmors9r9iYkR1NFjnMBYkj7OVhnGo-_rhjh67IMApE,824
+azure/ai/transcription/_version.py,sha256=Asg_DLffMngVmD1Oq-HAuVt6cCjN85ZAwBkwSJDeSPk,486
+azure/ai/transcription/py.typed,sha256=dcrsqJrcYfTX-ckLFJMTaj6mD8aDe2u0tkQG-ZYxnEg,26
+azure/ai/transcription/_operations/__init__.py,sha256=eFL_D7LwlwgDmM6AnUcGEGlCDzEnviNC_3AMhFl0V7E,951
+azure/ai/transcription/_operations/_operations.py,sha256=h5xiyk4EtmFAZwnyUIXyiN8Zyaxvou6_dx2OJRYPQLM,6219
+azure/ai/transcription/_operations/_patch.py,sha256=xsgXg12Jn1w2N_jYn-LntBJGOK2ilaq3a9nb4QKXMAM,5253
+azure/ai/transcription/_utils/__init__.py,sha256=nh5swTUwCBe3xsb9n60QMcuJ33d89Itwx7q9V-oDOUE,450
+azure/ai/transcription/_utils/model_base.py,sha256=_gvNGFrsOn1ijmwkCN_Bwpi3NFEWElVCcBoODJ5ry_E,50190
+azure/ai/transcription/_utils/serialization.py,sha256=swIoE4Jt5ZU2lWpsyfjw5hhbvTjVXDvFWFAi-LIRxbw,82386
+azure/ai/transcription/_utils/utils.py,sha256=eOC03Dd-p46RWZWcF9Xy3qGBiAhY5XGgnI50bpuWi5s,2456
+azure/ai/transcription/aio/__init__.py,sha256=837N-1lSBMBsb4KXhjkwKv0ZBrD_GJvlWkyPTNyMTY8,981
+azure/ai/transcription/aio/_client.py,sha256=h-hTGjOiMQx0sZzaGNd-RxUzdFkAtUWzeKtrlJH3seM,4891
+azure/ai/transcription/aio/_configuration.py,sha256=GZ5RBTx_yQuGKpUvydNpUtILuchtgNRr4rvJBV6qMrk,4014
+azure/ai/transcription/aio/_patch.py,sha256=bRmors9r9iYkR1NFjnMBYkj7OVhnGo-_rhjh67IMApE,824
+azure/ai/transcription/aio/_operations/__init__.py,sha256=eFL_D7LwlwgDmM6AnUcGEGlCDzEnviNC_3AMhFl0V7E,951
+azure/ai/transcription/aio/_operations/_operations.py,sha256=4QFtHotyHcrM4SOqTNhhRCjTlfdM3MLPaNB2tziETu0,5566
+azure/ai/transcription/aio/_operations/_patch.py,sha256=eXx5A7e_NgfrVCZPeGVD-bV8sRkOvtbryjgWrmN5o9A,5286
+azure/ai/transcription/models/__init__.py,sha256=uMxxXYjdtGW9yodYZiwy2am437UU-ovgh8LgGDI5Hhc,1475
+azure/ai/transcription/models/_enums.py,sha256=tLBH4nXjnH2TkM2jlR4GxapOJMojtwchwHv9_2jVO2c,923
+azure/ai/transcription/models/_models.py,sha256=tGN15ABqX7cmN-raJQ7j0cqPlLUnwqPFOZQa_-Swlj8,18791
+azure/ai/transcription/models/_patch.py,sha256=osT0tDiBrplag94iAXMapeAaQFIPi7ZiZduLzvtAgFQ,2474
+azure_ai_transcription-1.0.0b3.dist-info/licenses/LICENSE,sha256=_VMkgdgo4ToLE8y1mOAjOKNhd0BnWoYu5r3BVBto6T0,1073
+azure_ai_transcription-1.0.0b3.dist-info/METADATA,sha256=cTQdL3I9DdnujNCQJbnYTsIA8SuE3vavIr-y7BWlKOA,18834
+azure_ai_transcription-1.0.0b3.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
+azure_ai_transcription-1.0.0b3.dist-info/top_level.txt,sha256=S7DhWV9m80TBzAhOFjxDUiNbKszzoThbnrSz5MpbHSQ,6
+azure_ai_transcription-1.0.0b3.dist-info/RECORD,,

azure_ai_transcription-1.0.0b2.dist-info/RECORD

@@ -1,29 +0,0 @@
-azure/ai/transcription/__init__.py,sha256=EeG1egQNXEo3TvGAR2l71hUVkL7pKO_TQV0HTvIEB58,1034
-azure/ai/transcription/_client.py,sha256=ZkmcLb6RXzwlK05JZWA3aebQwd8ZKAgqiSJBuoUQM1I,4731
-azure/ai/transcription/_configuration.py,sha256=CIRFAOFt8P5TdHEZa-ERIO-mu9z_8q3C-ybCQX3MQeQ,3956
-azure/ai/transcription/_patch.py,sha256=bRmors9r9iYkR1NFjnMBYkj7OVhnGo-_rhjh67IMApE,824
-azure/ai/transcription/_version.py,sha256=g637Xd9Uf23mTrNOKxXc_oX7Wi-Zaz6tfo5NYxUwOr0,486
-azure/ai/transcription/py.typed,sha256=dcrsqJrcYfTX-ckLFJMTaj6mD8aDe2u0tkQG-ZYxnEg,26
-azure/ai/transcription/_operations/__init__.py,sha256=eFL_D7LwlwgDmM6AnUcGEGlCDzEnviNC_3AMhFl0V7E,951
-azure/ai/transcription/_operations/_operations.py,sha256=9X8Kta71welA6YPwLombQbSH5b2G7TCZ-ofXlC9vcZU,6250
-azure/ai/transcription/_operations/_patch.py,sha256=gLMQTM_JpldQjpiZ_FLP8LfKxvdd5w2yNkPWC95YR5c,5202
-azure/ai/transcription/_utils/__init__.py,sha256=nh5swTUwCBe3xsb9n60QMcuJ33d89Itwx7q9V-oDOUE,450
-azure/ai/transcription/_utils/model_base.py,sha256=Qv1mr4gg-BarrjYBIVs8bJb5iJH79D-Ekthh1PPw1To,45555
-azure/ai/transcription/_utils/serialization.py,sha256=WrHETL6uaaDLnB7TVbe25huhlLDm3aWBGphIutnJcA4,81946
-azure/ai/transcription/_utils/utils.py,sha256=gB49FiUuAk96jBy7psn-BBlyKUlSNeRJCmgXbu8mf-8,2330
-azure/ai/transcription/aio/__init__.py,sha256=837N-1lSBMBsb4KXhjkwKv0ZBrD_GJvlWkyPTNyMTY8,981
-azure/ai/transcription/aio/_client.py,sha256=O55d0-FKcK6JzFnBhCWVPFIkwTUo9QaacLyAWPS7BQ4,4890
-azure/ai/transcription/aio/_configuration.py,sha256=geuVLsMNT1XS6VRyfFkFvjDIgIAV0EJatsWm_eTS3Vo,4013
-azure/ai/transcription/aio/_patch.py,sha256=bRmors9r9iYkR1NFjnMBYkj7OVhnGo-_rhjh67IMApE,824
-azure/ai/transcription/aio/_operations/__init__.py,sha256=eFL_D7LwlwgDmM6AnUcGEGlCDzEnviNC_3AMhFl0V7E,951
-azure/ai/transcription/aio/_operations/_operations.py,sha256=PD2EMCI-gfH_sJa5OH8lNZPUrm34hUSlryVrX3mNzAg,5597
-azure/ai/transcription/aio/_operations/_patch.py,sha256=gDr6RNer6lM15-voBXg8z7JMdAWm5xW9CXkzY3EZaWk,5235
-azure/ai/transcription/models/__init__.py,sha256=uMxxXYjdtGW9yodYZiwy2am437UU-ovgh8LgGDI5Hhc,1475
-azure/ai/transcription/models/_enums.py,sha256=QDGZWb4mRd59XLWdVtAwrbTbWYz9VR2zu5IdT2GSm3E,921
-azure/ai/transcription/models/_models.py,sha256=rOSC0AujNtYaQscm-P7kCq4WQz_eglkz175JezeIL4w,18799
-azure/ai/transcription/models/_patch.py,sha256=bRmors9r9iYkR1NFjnMBYkj7OVhnGo-_rhjh67IMApE,824
-azure_ai_transcription-1.0.0b2.dist-info/licenses/LICENSE,sha256=_VMkgdgo4ToLE8y1mOAjOKNhd0BnWoYu5r3BVBto6T0,1073
-azure_ai_transcription-1.0.0b2.dist-info/METADATA,sha256=iZf72IGhIau6gMD5afu0PlgM5NPqC6tUYO6D9GFvtgM,18288
-azure_ai_transcription-1.0.0b2.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
-azure_ai_transcription-1.0.0b2.dist-info/top_level.txt,sha256=S7DhWV9m80TBzAhOFjxDUiNbKszzoThbnrSz5MpbHSQ,6
-azure_ai_transcription-1.0.0b2.dist-info/RECORD,,