Merge branch 'refactor/backend-architecture' into development

api/app/adapters/asr/tencent_asr.py

@@ -0,0 +1,57 @@
+"""Tencent Cloud ASR adapter — implements ASRProvider port."""
+
+import base64
+from app.core.logging import get_logger
+
+logger = get_logger(__name__)
+
+
+class TencentASRProvider:
+    def __init__(self, secret_id: str, secret_key: str):
+        self._secret_id = secret_id
+        self._secret_key = secret_key
+        self._client = None
+
+    def _get_client(self):
+        if self._client is not None:
+            return self._client
+        try:
+            from tencentcloud.asr.v20190614 import asr_client
+            from tencentcloud.common import credential
+            from tencentcloud.common.profile.client_profile import ClientProfile
+            from tencentcloud.common.profile.http_profile import HttpProfile
+
+            cred = credential.Credential(self._secret_id, self._secret_key)
+            http_profile = HttpProfile()
+            http_profile.endpoint = "asr.tencentcloudapi.com"
+            client_profile = ClientProfile()
+            client_profile.httpProfile = http_profile
+            self._client = asr_client.AsrClient(cred, "", client_profile)
+            return self._client
+        except Exception as e:
+            logger.error("Tencent ASR client init failed: %s", e)
+            return None
+
+    def ensure_ready(self) -> bool:
+        return bool(self._secret_id and self._secret_key and self._get_client())
+
+    async def transcribe(self, audio: bytes, format: str = "m4a") -> str:
+        client = self._get_client()
+        if not client:
+            return ""
+        try:
+            from tencentcloud.asr.v20190614 import models
+
+            audio_base64 = base64.b64encode(audio).decode("utf-8")
+            req = models.SentenceRecognitionRequest()
+            req.EngSerViceType = "16k_zh"
+            req.SourceType = 1
+            req.VoiceFormat = format
+            req.Data = audio_base64
+            req.DataLen = len(audio)
+
+            resp = client.SentenceRecognition(req)
+            return (resp.Result or "").strip()
+        except Exception as e:
+            logger.error("Tencent ASR transcribe failed: %s", e)
+            return ""