{"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,"search_vec":"'3.0.1459':33 'access':19 'api':18,62,68 'cadenc':48 'chang':63 'cloud':2,8,22 'evalu':12,29,67 'follow':35,45 'languag':28 'main':51 'modular':37 'orient':11 'packag':42 'provid':17 'python':6,16,55 'releas':47 'repositori':56 'sdk':4,14,44,54,69 'servic':25,61 'soe':3,13,24,65 'speech':10,66 'speech-ori':9 'spoken':27 'structur':38 'tencent':1,7,21 'tencentcloud':41,53,64 'tencentcloud-sdk-python':52 'tie':59 'updat':58 'version':32","created_at":"2026-05-09T05:55:04.484700+00:00","updated_at":"2026-05-09T05:55:04.484700+00:00","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,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"","cli_version":null,"type":"library","homepage":"https://www.tencentcloud.com","github":"https://github.com/TencentCloud/tencentcloud-sdk-python","docs":null,"changelog":null,"pypi":"https://pypi.org/project/tencentcloud-sdk-python-soe/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["gcp"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-29","install_tag":null}}