Registry / aws / tencentcloud-sdk-python-faceid

tencentcloud-sdk-python-faceid

library3.1.80pypypi✓ verified 84d ago

Official Tencent Cloud SDK for FaceID, providing facial recognition and liveness detection APIs. Current version 3.1.80. Releases follow Tencent Cloud SDK cadence, typically bi-weekly.

aws ai-ml

pip install tencentcloud-sdk-python-faceid

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · TENCENTCLOUD-SDK-P

tencentcloud-sdk-python-faceid

awspythonv3.1.80

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

FaceidClient

✓ from tencentcloud.faceid.v20180301 import faceid_client

✗ from tencentcloud.faceid import FaceidClient

Module version in path (v20180301) is required, else ImportError.

DetectAuthRequest

✓ from tencentcloud.faceid.v20180301 import models as faceid_models

✗ from tencentcloud.faceid.models import DetectAuthRequest

Models must be imported from the versioned subpackage.

Initialize client and call DetectAuth (face verification). Requires credentials and RuleId from Tencent Cloud console.

from tencentcloud.common import credential from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException from tencentcloud.faceid.v20180301 import faceid_client, models secret_id = os.environ.get('TENCENTCLOUD_SECRET_ID', '') secret_key = os.environ.get('TENCENTCLOUD_SECRET_KEY', '') cred = credential.Credential(secret_id, secret_key) client = faceid_client.FaceidClient(cred, "ap-guangzhou") req = models.DetectAuthRequest() req.RuleId = "your_rule_id" try: resp = client.DetectAuth(req) print(resp.to_json_string()) except TencentCloudSDKException as e: print(e)

Debug

Known issues

breakingThe SDK v3 major restructuring moved versioned subpackages; imports without v20180301 will fail.

fix

Use from tencentcloud.faceid.v20180301 import faceid_client, models

affects: >=3.0.0

deprecatedOld method `FaceidClient.__init__` without endpoint parameter is deprecated. Use `client = FaceidClient(cred, region, endpoint)` or default endpoint.

fix

Pass region as second argument; endpoint is optional.

affects: >=3.0.0

gotchaRegion parameter is required but many users omit it, causing client initialization failure.

fix

Always specify a region string (e.g., 'ap-guangzhou').

affects: All

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'tencentcloud.faceid'

Missing pip install tencentcloud-sdk-python-faceid, or missing common dependency.

fix

pip install tencentcloud-sdk-python-common tencentcloud-sdk-python-faceid

AttributeError: module 'tencentcloud.faceid' has no attribute 'v20180301'

Old style import without version subpackage; SDK v3 requires version in path.

fix

Use from tencentcloud.faceid.v20180301 import faceid_client

Upgrade

Version history

3.1.80latest on PyPI · released Apr 16, 2026

Audit

Dependencies

tencentcloud-sdk-python-commonrequiredCommon client and credential classes

Agent activity

26 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/TencentCloud/tencentcloud-sdk-python ↗

packagehttps://pypi.org/project/tencentcloud-sdk-python-faceid/ ↗

homepagehttps://cloud.tencent.com/product/faceid ↗