tencent cloud

APIs

Data Types

다운로드
포커스 모드
폰트 크기
마지막 업데이트 시간: 2026-06-23 16:19:32

FaceRect

Face box information

Used by actions: FuseFace, SubmitVideoFaceFusionJob.

Name Type Required Description
X Integer Yes Top-left X-axis coordinate of the face box
Y Integer Yes Top-left Y-axis coordinate of the face box
Width Integer Yes Face box width
Height Integer Yes Face box height

FuseFaceReviewDetail

Facial Information of Inappropriate Content Detection in Face Fusion

Used by actions: SubmitVideoFaceFusionJob.

Name Type Description
Field String Reserved field
Label String Label Names Matched by Content Moderation
Confidence Float Confidence score of the detection label. A higher score means a greater likelihood of violations.
0-70: Suggestion = PASS
70-80: Suggestion = REVIEW
80-100: Suggestion = BLOCK
Suggestion String Moderation Conclusion for Detection Scenarios
PASS: Normal
REVIEW: Suspicious
BLOCK: Violation

FuseFaceReviewResult

Face Fusion Inappropriate Content Detection Response Parameter item

Used by actions: SubmitVideoFaceFusionJob.

Name Type Description
Category String Reserved field
Code String Status code. 0 indicates successful processing; other values indicate failure.
CodeDescription String Corresponding Status Code Description
Confidence Float Reserved field
Suggestion String Reserved field
DetailSet Array of FuseFaceReviewDetail Detailed Moderation Content

FuseParam

Fusion parameter

Used by actions: FuseFace.

Name Type Required Description
ImageCodecParam ImageCodecParam No Image encoding parameter

ImageCodecParam

Image encoding parameter

Used by actions: FuseFace.

Name Type Required Description
MetaData Array of MetaData No Metadata. The number of metadata entries cannot exceed 1.

LogoParam

Logo parameter

Used by actions: FuseFace, SubmitVideoFaceFusionJob.

Name Type Required Description
LogoRect FaceRect Yes Coordinates of the logo image in the fusion result image. The logo image will be stretched according to the coordinates.
LogoUrl String No Logo image URL
●Either the Base64 code or URL must be provided. If both are provided, URL prevails.
●Supported image format: JPG or PNG
LogoImage String No Logo image Base64 code
●Either the Base64 code or URL must be provided. If both are provided, URL prevails.
●Supported image format: JPG or PNG

MergeInfo

Face position information on the face image and material template image for fusion

Used by actions: FuseFace, SubmitVideoFaceFusionJob.

Name Type Required Description
Image String No Enter the image Base64 code.
●Either the Base64 code or URL must be provided. If both are provided, URL prevails.
●Material image limitation: face size in the image greater than 34×34 pixels; image size greater than 64×64 pixels. (After encoding, the image size may increase by about 30%. It is recommended to control the image size reasonably.)
●Supported image format: JPG or PNG
Url String No Enter the image URL.
●Either the Base64 code or URL must be provided. If both are provided, URL prevails.
●Material image limitation: face size in the image greater than 34×34 pixels; image size greater than 64×64 pixels. (After encoding, the image size may increase by about 30%. It is recommended to control the image size reasonably.)
●Supported image format: JPG or PNG
InputImageFaceRect FaceRect No Face position information (face box) on the uploaded image
Width and height are no less than 30.
TemplateFaceID String No Material face ID. If this parameter is left blank, the largest face is used by default.
TemplateFaceRect FaceRect No Face position information (face box) on the template. If this parameter is left blank, the largest face is used by default. This parameter applies to scenes where custom material templates are used for fusion.
Width and height are no less than 30.

MetaData

Metadata structure, in key/value format

Used by actions: FuseFace, SubmitVideoFaceFusionJob.

Name Type Required Description
MetaKey String Yes Metadata key
MetaValue String Yes Metadata value

VideoFaceFusionOutput

Returned video face fusion result

Used by actions: QueryVideoFaceFusionJob.

Name Type Description
VideoUrl String URL of the video output after video face fusion
VideoMD5 String MD5 value of the video output after video face fusion, which is used for verification
Width Integer Video width
Height Integer Video height
FPS Integer Frames per second
DurationInSec Float Video duration, in seconds
Frame Integer Number of frames

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백