{"id":28355,"library":"tencentcloud-sdk-python-soe","title":"Tencent Cloud SOE SDK for Python","description":"Tencent Cloud Speech-Oriented Evaluation (SOE) SDK for Python. Provides API access to Tencent Cloud's SOE service for spoken language evaluation. As of version 3.0.1459, it follows a modular structure under the tencentcloud package. The SDK follows the release cadence of the main tencentcloud-sdk-python repository, with updates tied to service API changes.","status":"active","version":"3.0.1459","language":"python","source_language":"en","source_url":"https://github.com/TencentCloud/tencentcloud-sdk-python","tags":["tencentcloud","soe","speech evaluation","api sdk"],"install":[{"cmd":"pip install tencentcloud-sdk-python-soe","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Required for client initialization and credential handling.","package":"tencentcloud-sdk-python-common","optional":false}],"imports":[{"note":"Import path uses the API version (v20180724) as a subpackage.","wrong":null,"symbol":"SoeClient","correct":"from tencentcloud.soe.v20180724 import soe_client"},{"note":"Models are in the same version-specific module.","wrong":null,"symbol":"models","correct":"from tencentcloud.soe.v20180724 import models"}],"quickstart":{"code":"from tencentcloud.common import credential\nfrom tencentcloud.soe.v20180724 import soe_client, models\nimport os\n\ncred = credential.Credential(\n    os.environ.get('TENCENTCLOUD_SECRET_ID', ''),\n    os.environ.get('TENCENTCLOUD_SECRET_KEY', '')\n)\nclient = soe_client.SoeClient(cred, 'ap-guangzhou')\nreq = models.InitOralProcessRequest()\nreq.SessionId = 'session_12345'\nreq.RefText = 'test'\nreq.WorkMode = 1\nreq.EvalMode = 1\nreq.StorageMode = 0\nresp = client.InitOralProcess(req)\nprint(resp.to_json_string())","lang":"python","description":"Initialize the SOE client and perform an oral process request."},"warnings":[{"fix":"Install both packages: pip install tencentcloud-sdk-python-common tencentcloud-sdk-python-soe","message":"The SDK requires both 'tencentcloud-sdk-python-common' and 'tencentcloud-sdk-python-soe' to be installed separately.","severity":"gotcha","affected_versions":"all"},{"fix":"Supply a valid region string (e.g., 'ap-guangzhou', 'ap-beijing') to the client constructor.","message":"Region must be specified explicitly; there is no default fallback. Using an invalid region leads to API errors.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"pip install tencentcloud-sdk-python-soe","cause":"Did not install the SOE-specific package or installed only the common package.","error":"ModuleNotFoundError: No module named 'tencentcloud.soe'"},{"fix":"Check the official Tencent Cloud SOE region list and pass a valid region like 'ap-guangzhou'.","cause":"Region not valid for SOE service.","error":"tencentcloud.common.exception.TencentCloudSDKException: The region is not supported for the product."}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}