From 0cca7080e929b7853a0f8d38342fdc742fdc8d1a Mon Sep 17 00:00:00 2001
From: gsharp-aai <gsharp@assemblyai.com>
Date: Fri, 31 Jul 2026 13:12:53 -0400
Subject: [PATCH] feat: add localization option to language_detection_options

Exposes the `localization` option on `language_detection_options`. When
language detection resolves to English, `localization` renders the transcript
in a regional spelling variant (e.g. "en_au", "en_uk"). Also threaded through
the `set_language_detection` config helper.
---
 assemblyai/__version__.py |  2 +-
 assemblyai/types.py       | 14 +++++++++++++-
 2 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/assemblyai/__version__.py b/assemblyai/__version__.py
index f9a0e54..c7b8c61 100644
--- a/assemblyai/__version__.py
+++ b/assemblyai/__version__.py
@@ -1 +1 @@
-__version__ = "0.64.32"
+__version__ = "0.64.33"
diff --git a/assemblyai/types.py b/assemblyai/types.py
index e20b1c3..48ac0fe 100644
--- a/assemblyai/types.py
+++ b/assemblyai/types.py
@@ -639,6 +639,10 @@ class LanguageDetectionOptions(BaseModel):
         None,
         description="The language detection model to use.",
     )
+    localization: Optional[List[str]] = Field(
+        None,
+        description='Locale codes (e.g. ["en_au"]) to render detected English in a regional spelling variant. Supported values are "en_au" and "en_uk"; at most one locale per language.',
+    )
 
 
 class CodeSwitchingLanguage(BaseModel):
@@ -1969,6 +1973,7 @@ def set_language_detection(
         expected_languages: Optional[List[str]] = None,
         fallback_language: Optional[str] = None,
         on_low_language_confidence: Optional[str] = None,
+        localization: Optional[List[str]] = None,
     ) -> Self:
         """
         Enable Automatic Language Detection with optional configuration.
@@ -1979,6 +1984,7 @@ def set_language_detection(
             expected_languages: A list of languages that the audio could be expected to be.
             fallback_language: The language to fallback to if detection fails.
             on_low_language_confidence: Controls behavior when language confidence is below threshold. Either "error" (default) or "fallback".
+            localization: Locale codes (e.g. ["en_au"]) to render detected English in a regional spelling variant. Supported values are "en_au" and "en_uk".
         """
 
         if not enable:
@@ -1992,12 +1998,18 @@ def set_language_detection(
             confidence_threshold
         )
 
-        if expected_languages or fallback_language or on_low_language_confidence:
+        if (
+            expected_languages
+            or fallback_language
+            or on_low_language_confidence
+            or localization
+        ):
             self._raw_transcription_config.language_detection_options = (
                 LanguageDetectionOptions(
                     expected_languages=expected_languages,
                     fallback_language=fallback_language,
                     on_low_language_confidence=on_low_language_confidence,
+                    localization=localization,
                 )
             )