;
}
/**
* 用于返回分类模型命中子标签的详细结果
*/
export interface LabelDetailItem {
/**
* 该字段用于返回识别对象的ID以方便识别和区分。
*/
Id?: number;
/**
* 该字段用于返回时命中的子标签名称。
*/
Name?: string;
/**
* 该字段用于返回对应子标签命中的分值,取值为**0-100**,如:*Porn-SexBehavior 99* 则代表相应识别内容命中色情-性行为标签的分值为99。
*/
Score?: number;
}
/**
* CreateImageModerationAsyncTask请求参数结构体
*/
export interface CreateImageModerationAsyncTaskRequest {
/**
* 接收审核信息回调地址,审核过程中产生的所有结果发送至此地址。
*/
CallbackUrl: string;
/**
* 该字段表示策略的具体编号,用于接口调度,在内容安全控制台中可配置。若不传入Biztype参数(留空),则代表采用默认的识别策略;传入则会在审核时根据业务场景采取不同的审核策略。
备注:Biztype仅为数字、字母与下划线的组合,长度为3-32个字符;不同Biztype关联不同的业务场景与识别能力策略,调用前请确认正确的Biztype。
*/
BizType?: string;
/**
* 该字段表示您为待检测对象分配的数据ID,传入后可方便您对文件进行标识和管理。
取值:由英文字母(大小写均可)、数字及四个特殊符号(_,-,@,#)组成,长度不超过64个字符。
*/
DataId?: string;
/**
* 该字段表示待检测图片文件内容的Base64编码,图片大小不超过10MB,建议分辨率不低于256x256,否则可能会影响识别效果。
备注: 该字段与FileUrl必须选择输入其中一个。
*/
FileContent?: string;
/**
* 该字段表示待检测图片文件的访问链接,图片支持PNG、JPG、JPEG、BMP、GIF、WEBP格式,大小不超过100MB,建议分辨率不低于256x256;图片下载时间限制为3秒,超过则会返回下载超时;由于网络安全策略,送审带重定向的链接,可能引起下载失败,请尽量避免,比如Http返回302状态码的链接,可能导致接口返回ResourceUnavailable.ImageDownloadError。
备注:该字段与FileContent必须选择输入其中一个。
*/
FileUrl?: string;
/**
* GIF/长图检测专用,用于表示GIF截帧频率(每隔多少张图片抽取一帧进行检测),长图则按照长边:短边取整计算要切割的总图数;默认值为0,此时只会检测GIF的第一帧或对长图不进行切分处理。
备注:Interval与MaxFrames参数需要组合使用。例如,Interval=3, MaxFrames=400,则代表在检测GIF/长图时,将每间隔2帧检测一次且最多检测400帧。
*/
Interval?: number;
/**
* GIF/长图检测专用,用于标识最大截帧数量;默认值为1,此时只会检测输入GIF的第一帧或对长图不进行切分处理(可能会造成处理超时)。
备注:Interval与MaxFrames参数需要组合使用。例如,Interval=3, MaxFrames=400,则代表在检测GIF/长图时,将每间隔2帧检测一次且最多检测400帧。
*/
MaxFrames?: number;
/**
* 该字段表示待检测对象对应的用户相关信息,若填入则可甄别相应违规风险用户。
*/
User?: User;
/**
* 该字段表示待检测对象对应的设备相关信息,若填入则可甄别相应违规风险设备。
*/
Device?: Device;
/**
* 服务类型,可为空,默认为 IMAGE。
枚举值:
- IMAGE: 一般图片异步检测
- IMAGE_LLM: 大模型图片异步检测
*/
Type?: string;
}
/**
* 用于返回黑白库比对结果的详细信息
*/
export interface LibResult {
/**
* 该字段表示模型的场景识别结果,默认取值为Similar。
*/
Scene?: string;
/**
* 该字段用于返回后续操作建议。当您获取到判定结果后,返回值表示系统推荐的后续操作;建议您按照业务所需,对不同违规类型与建议值进行处理。
返回值:**Block**:建议屏蔽,**Review** :建议人工复审,**Pass**:建议通过
*/
Suggestion?: string;
/**
* 该字段用于返回检测结果所对应的恶意标签。
返回值:**Normal**:正常,**Porn**:色情,**Abuse**:谩骂,**Ad**:广告;以及其他令人反感、不安全或不适宜的内容类型。
*/
Label?: string;
/**
* 该字段用于返回恶意标签下对应的子标签的检测结果,如:*Porn-SexBehavior*等子标签。
注意:此字段可能返回 null,表示取不到有效值。
*/
SubLabel?: string;
/**
* 该字段用于返回图片检索模型识别的分值,取值为**0-100**,表示该审核图片**与库中样本的相似分值**,得分越高,代表当前内容越有可能命中相似图库内的样本。
*/
Score?: number;
/**
* 该字段用于返回黑白库比对结果的详细信息,如:序号、库名称、恶意标签等信息;详细返回信息敬请参考对应数据结构([LibDetail](https://cloud.tencent.com/document/product/1125/53274#LibDetail))的描述文档
*/
Details?: Array;
}
/**
* ImageModeration返回参数结构体
*/
export interface ImageModerationResponse {
/**
* 该字段用于返回Label标签下的后续操作建议。当您获取到判定结果后,返回值表示系统推荐的后续操作;建议您按照业务所需,对不同违规类型与建议值进行处理。
返回值:**Block**:建议屏蔽,**Review** :建议人工复审,**Pass**:建议通过
*/
Suggestion?: string;
/**
* 该字段用于返回检测结果(LabelResults)中所对应的**优先级最高的恶意标签**,表示模型推荐的审核结果,建议您按照业务所需,对不同违规类型与建议值进行处理。
返回值标签示例:**Normal**:正常,**Porn**:色情,**Abuse**:谩骂,**Ad**:广告;(说明:文档仅示例了部分风险类型,更多返回类型请以实际值为准或[提交工单](https://console.cloud.tencent.com/workorder/category)进行咨询)。
*/
Label?: string;
/**
* 该字段用于返回检测结果所命中优先级最高的恶意标签下的子标签名称,如:*色情--性行为*;若未命中任何子标签则返回空字符串。
*/
SubLabel?: string;
/**
* 该字段用于返回当前标签(Label)下的置信度,取值范围:0(**置信度最低**)-100(**置信度最高** ),越高代表图片越有可能属于当前返回的标签;如:*色情 99*,则表明该图片非常有可能属于色情内容;*色情 0*,则表明该图片不属于色情内容。
*/
Score?: number;
/**
* 该字段用于返回分类检测模型的详细检测结果;表示模型推荐的审核结果,建议您按照业务所需,对不同违规类型与建议值进行处理。详细返回值信息可参阅对应的数据结构(LabelResults)描述。
返回值标签示例:Normal:正常,Porn:色情,Abuse:谩骂,Ad:广告(说明:文档仅示例了部分风险类型,更多返回类型请以实际值为准或[提交工单](https://console.cloud.tencent.com/workorder/category)进行咨询)
注意:此字段可能返回 null,表示取不到有效值。
*/
LabelResults?: Array;
/**
* 该字段用于返回物体检测模型的详细检测结果;包括:实体、广告台标、二维码等内容命中的标签名称、标签分数、坐标信息、场景识别结果、建议操作等内容审核信息;详细返回值信息可参阅对应的数据结构(ObjectResults)描述。
*/
ObjectResults?: Array;
/**
* 该字段用于返回OCR文本识别的详细检测结果;包括:文本坐标信息、文本识别结果、建议操作等内容审核信息;详细返回值信息可参阅对应的数据结构(OcrResults)描述。
*/
OcrResults?: Array;
/**
* 该字段用于返回基于图片风险库(风险黑库与正常白库)识别的结果,详细返回值信息可参阅对应的数据结构(LibResults)描述。
备注:图片风险库目前**暂不支持自定义库**。
*/
LibResults?: Array;
/**
* 该字段用于返回检测对象对应请求参数中的DataId。
*/
DataId?: string;
/**
* 该字段用于返回检测对象对应请求参数中的BizType。
*/
BizType?: string;
/**
* 该字段用于返回根据您的需求配置的额外附加信息(Extra),如未配置则默认返回值为空。
备注:不同客户或Biztype下返回信息不同,如需配置该字段请提交工单咨询或联系售后专员处理。
注意:此字段可能返回 null,表示取不到有效值。
*/
Extra?: string;
/**
* 该字段用于返回检测对象对应的MD5校验值,以方便校验文件完整性。
*/
FileMD5?: string;
/**
* 该字段用于返回仅识别图片元素的模型结果;包括:场景模型命中的标签、置信度和位置信息
*/
RecognitionResults?: Array;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 标识命中的违规关键词位置信息
*/
export interface Positions {
/**
* 关键词起始位置
*/
Start?: number;
/**
* 关键词结束位置
*/
End?: number;
}
/**
* 用于表示业务用户的账号相关信息
*/
export interface User {
/**
* 该字段表示业务用户ID,填写后,系统可根据账号过往违规历史优化审核结果判定,有利于存在可疑违规风险时的辅助判断。
备注:该字段可传入微信openid、QQopenid、字符串等账号信息,与账号类别参数(AccountType)配合使用可确定唯一账号。
*/
UserId?: string;
/**
* 该字段表示业务用户对应的账号昵称信息。
*/
Nickname?: string;
/**
* 该字段表示业务用户ID对应的账号类型,取值:**1**-微信uin,**2**-QQ号,**3**-微信群uin,**4**-qq群号,**5**-微信openid,**6**-QQopenid,**7**-其它string。
该字段与账号ID参数(UserId)配合使用可确定唯一账号。
*/
AccountType?: string;
/**
* 该字段表示业务用户对应账号的性别信息。
取值:**0**(默认值,代表性别未知)、**1**(男性)、**2**(女性)。
*/
Gender?: number;
/**
* 该字段表示业务用户对应账号的年龄信息。
取值:**0**(默认值,代表年龄未知)-(**自定义年龄上限**)之间的整数。
*/
Age?: number;
/**
* 该字段表示业务用户对应账号的等级信息。
取值:**0**(默认值,代表等级未知)、**1**(等级较低)、**2**(等级中等)、**3**(等级较高),目前**暂不支持自定义等级**。
*/
Level?: number;
/**
* 该字段表示业务用户对应账号的手机号信息,支持全球各地区手机号的记录。
备注:请保持手机号格式的统一,如区号格式(086/+86)等。
*/
Phone?: string;
/**
* 该字段表示业务用户的简介信息,支持汉字、英文及特殊符号,**长度不超过5000个汉字字符**。
*/
Desc?: string;
/**
* 该字段表示业务用户头像图片的访问链接(URL),支持PNG、JPG、JPEG、BMP、GIF、WEBP格式。
备注:头像图片**大小不超过5MB**,建议**分辨率不低于256x256**;图片下载时间限制为3秒,超过则会返回下载超时。
*/
HeadUrl?: string;
}