v20201229

package
v1.2.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Apr 29, 2021 License: Apache-2.0 Imports: 5 Imported by: 0

Documentation

Index

Constants

View Source 
const APIVersion = "2020-12-29"

Variables

This section is empty.

Functions

This section is empty.

Types

type Client 

type Client struct {
	common.Client
}

func NewClient 

func NewClient(credential *common.Credential, region string, clientProfile *profile.ClientProfile) (client *Client, err error)

func NewClientWithSecretId 

func NewClientWithSecretId(secretId, secretKey, region string) (client *Client, err error)

Deprecated

func (*Client) ImageModeration 

func (c *Client) ImageModeration(request *ImageModerationRequest) (response *ImageModerationResponse, err error)

图片内容检测服务（Image Moderation, IM）能自动扫描图片，识别可能令人反感、不安全或不适宜的内容，同时支持用户配置图片黑名单，打击自定义识别类型的图片。

<div class="rno-api-explorer" style="margin-bottom:20px"> 

<div class="rno-api-explorer-inner">
    <div class="rno-api-explorer-hd">
        <div class="rno-api-explorer-title">
            关于版本迭代的描述
        </div>
    </div>
    <div class="rno-api-explorer-body">
        <div class="rno-api-explorer-cont">
            <p>当前页面版本为图片内容安全2020版本，2020.11.3日前接入的图片内容安全接口为2019版本，在此时间前接入的用户可直接访问以下链接进行维护操作：<a href="https://cloud.tencent.com/document/product/1125/38206" target="_blank">图片内容安全-2019版本</a></p>
            <p>2020版本相对2019版本进行了升级，支持更灵活的多场景业务策略配置以及更丰富的识别回调信息，满足不同业务的识别需求，建议按照2020版本接入指引进行接口升级；同时，2019版本也会持续维护直至用户不再使用为止。</p>
        </div>
    </div>
</div>

</div>

func (*Client) ImageRecognition 

func (c *Client) ImageRecognition(request *ImageRecognitionRequest) (response *ImageRecognitionResponse, err error)

图片内容审核服务能自动扫描图片，识别可能令人反感、不安全或不适宜的内容，同时支持用户配置图片黑名单，打击自定义识别类型的图片。

type Device 

type Device struct {

	// 发表消息设备IP
	Ip *string `json:"Ip,omitempty" name:"Ip"`

	// Mac地址
	Mac *string `json:"Mac,omitempty" name:"Mac"`

	// 设备指纹Token
	TokenId *string `json:"TokenId,omitempty" name:"TokenId"`

	// 设备指纹ID
	DeviceId *string `json:"DeviceId,omitempty" name:"DeviceId"`

	// 设备序列号
	IMEI *string `json:"IMEI,omitempty" name:"IMEI"`

	// IOS设备，Identifier For Advertising（广告标识符）
	IDFA *string `json:"IDFA,omitempty" name:"IDFA"`

	// IOS设备，IDFV - Identifier For Vendor（应用开发商标识符）
	IDFV *string `json:"IDFV,omitempty" name:"IDFV"`

	// IP地址类型 0 代表ipv4 1 代表ipv6
	IpType *uint64 `json:"IpType,omitempty" name:"IpType"`
}

type ImageModerationRequest 

type ImageModerationRequest struct {
	*tchttp.BaseRequest

	// 该字段用于标识业务场景。您可以在内容安全控制台创建对应的ID，配置不同的内容审核策略，通过接口调用，默认不填为0，后端使用默认策略。 -- 该字段暂未开放。
	BizType *string `json:"BizType,omitempty" name:"BizType"`

	// 数据ID，可以由英文字母、数字、下划线、-、@#组成，不超过64个字符
	DataId *string `json:"DataId,omitempty" name:"DataId"`

	// 数据Base64编码，图片检测接口为图片文件内容，大小不能超过5M
	FileContent *string `json:"FileContent,omitempty" name:"FileContent"`

	// 图片资源访问链接，__与FileContent参数必须二选一输入__
	FileUrl *string `json:"FileUrl,omitempty" name:"FileUrl"`

	// 截帧频率，GIF图/长图检测专用，默认值为0，表示只会检测GIF图/长图的第一帧
	Interval *int64 `json:"Interval,omitempty" name:"Interval"`

	// GIF图/长图检测专用，代表均匀最大截帧数量，默认值为1（即只取GIF第一张，或长图不做切分处理（可能会造成处理超时））。
	MaxFrames *int64 `json:"MaxFrames,omitempty" name:"MaxFrames"`

	// 账号相关信息字段，填入后可识别违规风险账号。
	User *User `json:"User,omitempty" name:"User"`

	// 设备相关信息字段，填入后可识别违规风险设备。
	Device *Device `json:"Device,omitempty" name:"Device"`
}

func NewImageModerationRequest 

func NewImageModerationRequest() (request *ImageModerationRequest)

func (*ImageModerationRequest) FromJsonString 

func (r *ImageModerationRequest) FromJsonString(s string) error

It is highly **NOT** recommended to use this function because it has no param check, nor strict type check

func (*ImageModerationRequest) ToJsonString 

func (r *ImageModerationRequest) ToJsonString() string

type ImageModerationResponse 

type ImageModerationResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 建议您拿到判断结果后的执行操作。
		// 建议值，Block：建议屏蔽，Review：建议复审，Pass：建议通过
		Suggestion *string `json:"Suggestion,omitempty" name:"Suggestion"`

		// 恶意标签，Normal：正常，Porn：色情，Abuse：谩骂，Ad：广告，Custom：自定义图片。
		// 以及其他令人反感、不安全或不适宜的内容类型。
		Label *string `json:"Label,omitempty" name:"Label"`

		// 子标签名称，如色情--性行为；当未命中子标签时，返回空字符串；
		SubLabel *string `json:"SubLabel,omitempty" name:"SubLabel"`

		// 机器判断当前分类的置信度，取值范围：0.00~100.00。分数越高，表示越有可能属于当前分类。
		// （如：色情 99.99，则该样本属于色情的置信度非常高。）
		Score *int64 `json:"Score,omitempty" name:"Score"`

		// 智能模型的识别结果，包括涉黄、广告等令人反感、不安全或不适宜的内容类型识别结果。
		// 注意：此字段可能返回 null，表示取不到有效值。
		LabelResults []*LabelResult `json:"LabelResults,omitempty" name:"LabelResults" list`

		// 物体检测模型的审核结果，包括实体、广告台标/二维码等物体坐标信息与内容审核信息。
		// 注意：此字段可能返回 null，表示取不到有效值。
		ObjectResults []*ObjectResult `json:"ObjectResults,omitempty" name:"ObjectResults" list`

		// OCR识别后的文本识别结果，包括文本所处图片的OCR坐标信息以及图片文本的识别结果。
		// 注意：此字段可能返回 null，表示取不到有效值。
		OcrResults []*OcrResult `json:"OcrResults,omitempty" name:"OcrResults" list`

		// 基于图片风险库识别的结果。
		// 风险库包括不安全黑库与正常白库的结果。
		// 注意：此字段可能返回 null，表示取不到有效值。
		LibResults []*LibResult `json:"LibResults,omitempty" name:"LibResults" list`

		// 请求参数中的DataId。
		DataId *string `json:"DataId,omitempty" name:"DataId"`

		// 您在入参时所填入的Biztype参数。 -- 该字段暂未开放。
		BizType *string `json:"BizType,omitempty" name:"BizType"`

		// 扩展字段，用于特定信息返回，不同客户/Biztype下返回信息不同。
		// 注意：此字段可能返回 null，表示取不到有效值。
		// 注意：此字段可能返回 null，表示取不到有效值。
		Extra *string `json:"Extra,omitempty" name:"Extra"`

		// 图片MD5值
		FileMD5 *string `json:"FileMD5,omitempty" name:"FileMD5"`

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

func NewImageModerationResponse 

func NewImageModerationResponse() (response *ImageModerationResponse)

func (*ImageModerationResponse) FromJsonString 

func (r *ImageModerationResponse) FromJsonString(s string) error

It is highly **NOT** recommended to use this function because it has no param check, nor strict type check

func (*ImageModerationResponse) ToJsonString 

func (r *ImageModerationResponse) ToJsonString() string

type ImageRecognitionRequest 

type ImageRecognitionRequest struct {
	*tchttp.BaseRequest

	// 渠道ID，必须与主调账号一致，由天御分配并与API调用账号绑定
	Channel *uint64 `json:"Channel,omitempty" name:"Channel"`

	// 产品侧腾讯云用户账号AppId
	CustomAppId *string `json:"CustomAppId,omitempty" name:"CustomAppId"`

	// 该字段用于标识业务场景。您可以在内容安全控制台创建对应的ID，配置不同的内容审核策略，通过接口调用，默认不填为0，后端使用默认策略。 -- 该字段暂未开放。
	BizType *string `json:"BizType,omitempty" name:"BizType"`

	// 数据ID，可以由英文字母、数字、下划线、-、@#组成，不超过64个字符
	DataId *string `json:"DataId,omitempty" name:"DataId"`

	// 数据Base64编码，图片检测接口为图片文件内容，大小不能超过5M
	FileContent *string `json:"FileContent,omitempty" name:"FileContent"`

	// 图片资源访问链接，__与FileContent参数必须二选一输入__
	FileUrl *string `json:"FileUrl,omitempty" name:"FileUrl"`

	// 截帧频率，GIF图/长图检测专用，默认值为0，表示只会检测GIF图/长图的第一帧
	Interval *int64 `json:"Interval,omitempty" name:"Interval"`

	// GIF图/长图检测专用，代表均匀最大截帧数量，默认值为1（即只取GIF第一张，或长图不做切分处理（可能会造成处理超时））。
	MaxFrames *int64 `json:"MaxFrames,omitempty" name:"MaxFrames"`

	// 账号相关信息字段，填入后可识别违规风险账号。
	User *User `json:"User,omitempty" name:"User"`

	// 设备相关信息字段，填入后可识别违规风险设备。
	Device *Device `json:"Device,omitempty" name:"Device"`

	// 产品侧腾讯云用户账号Uin
	CustomUin *string `json:"CustomUin,omitempty" name:"CustomUin"`

	// 产品侧腾讯云用户子账号Uin
	CustomSubAccountUin *string `json:"CustomSubAccountUin,omitempty" name:"CustomSubAccountUin"`

	// 视频流ID
	StreamId *string `json:"StreamId,omitempty" name:"StreamId"`
}

func NewImageRecognitionRequest 

func NewImageRecognitionRequest() (request *ImageRecognitionRequest)

func (*ImageRecognitionRequest) FromJsonString 

func (r *ImageRecognitionRequest) FromJsonString(s string) error

It is highly **NOT** recommended to use this function because it has no param check, nor strict type check

func (*ImageRecognitionRequest) ToJsonString 

func (r *ImageRecognitionRequest) ToJsonString() string

type ImageRecognitionResponse 

type ImageRecognitionResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 建议您拿到判断结果后的执行操作。
		// 建议值，Block：建议屏蔽，Review：建议复审，Pass：建议通过
		Suggestion *string `json:"Suggestion,omitempty" name:"Suggestion"`

		// 恶意标签，Normal：正常，Porn：色情，Abuse：谩骂，Ad：广告，Custom：自定义图片。
		// 以及令人反感、不安全或不适宜的内容类型。
		Label *string `json:"Label,omitempty" name:"Label"`

		// 子标签名称，如色情--性行为；当未命中子标签时，返回空字符串；
		SubLabel *string `json:"SubLabel,omitempty" name:"SubLabel"`

		// 机器判断当前分类的置信度，取值范围：0.00~100.00。分数越高，表示越有可能属于当前分类。
		// （如：色情 99.99，则该样本属于色情的置信度非常高。）
		Score *int64 `json:"Score,omitempty" name:"Score"`

		// 智能模型的识别结果，包括涉黄、广告等令人反感、不安全或不适宜的内容类型识别结果。
		// 注意：此字段可能返回 null，表示取不到有效值。
		LabelResults []*LabelResult `json:"LabelResults,omitempty" name:"LabelResults" list`

		// 物体检测模型的审核结果，包括实体、广告台标/二维码等物体坐标信息与内容审核信息。
		// 注意：此字段可能返回 null，表示取不到有效值。
		ObjectResults []*ObjectResult `json:"ObjectResults,omitempty" name:"ObjectResults" list`

		// OCR识别后的文本识别结果，包括文本所处图片的OCR坐标信息以及图片文本的识别结果。
		// 注意：此字段可能返回 null，表示取不到有效值。
		OcrResults []*OcrResult `json:"OcrResults,omitempty" name:"OcrResults" list`

		// 基于图片风险库识别的结果。
		// 风险库包括不安全黑库与正常白库的结果。
		// 注意：此字段可能返回 null，表示取不到有效值。
		LibResults []*LibResult `json:"LibResults,omitempty" name:"LibResults" list`

		// 请求参数中的DataId。
		DataId *string `json:"DataId,omitempty" name:"DataId"`

		// 您在入参时所填入的Biztype参数。 -- 该字段暂未开放。
		BizType *string `json:"BizType,omitempty" name:"BizType"`

		// 扩展字段，用于特定信息返回，不同客户/Biztype下返回信息不同。
		// 注意：此字段可能返回 null，表示取不到有效值。
		// 注意：此字段可能返回 null，表示取不到有效值。
		Extra *string `json:"Extra,omitempty" name:"Extra"`

		// 图片MD5值
		FileMD5 *string `json:"FileMD5,omitempty" name:"FileMD5"`

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

func NewImageRecognitionResponse 

func NewImageRecognitionResponse() (response *ImageRecognitionResponse)

func (*ImageRecognitionResponse) FromJsonString 

func (r *ImageRecognitionResponse) FromJsonString(s string) error

It is highly **NOT** recommended to use this function because it has no param check, nor strict type check

func (*ImageRecognitionResponse) ToJsonString 

func (r *ImageRecognitionResponse) ToJsonString() string

type LabelDetailItem 

type LabelDetailItem struct {

	// 序号
	// 注意：此字段可能返回 null，表示取不到有效值。
	Id *int64 `json:"Id,omitempty" name:"Id"`

	// 子标签名称
	// 注意：此字段可能返回 null，表示取不到有效值。
	Name *string `json:"Name,omitempty" name:"Name"`

	// 子标签分数
	// 注意：此字段可能返回 null，表示取不到有效值。
	Score *uint64 `json:"Score,omitempty" name:"Score"`
}

type LabelResult 

type LabelResult struct {

	// 场景识别结果
	Scene *string `json:"Scene,omitempty" name:"Scene"`

	// 建议您拿到判断结果后的执行操作。
	// 建议值，Block：建议屏蔽，Review：建议复审，Pass：建议通过
	Suggestion *string `json:"Suggestion,omitempty" name:"Suggestion"`

	// 恶意标签，Normal：正常，Porn：色情，Abuse：谩骂，Ad：广告，Custom：自定义图片。
	// 以及其他令人反感、不安全或不适宜的内容类型。
	Label *string `json:"Label,omitempty" name:"Label"`

	// 子标签检测结果
	SubLabel *string `json:"SubLabel,omitempty" name:"SubLabel"`

	// 该标签模型命中的分值
	Score *uint64 `json:"Score,omitempty" name:"Score"`

	// 分类模型命中子标签结果
	// 注意：此字段可能返回 null，表示取不到有效值。
	Details []*LabelDetailItem `json:"Details,omitempty" name:"Details" list`
}

type LibDetail 

type LibDetail struct {

	// 序号
	Id *int64 `json:"Id,omitempty" name:"Id"`

	// 仅当Label为Custom自定义关键词时有效，表示自定义库id
	LibId *string `json:"LibId,omitempty" name:"LibId"`

	// 仅当Label为Custom自定义关键词时有效，表示自定义库名称
	// 注意：此字段可能返回 null，表示取不到有效值。
	LibName *string `json:"LibName,omitempty" name:"LibName"`

	// 图片ID
	ImageId *string `json:"ImageId,omitempty" name:"ImageId"`

	// 恶意标签，Normal：正常，Porn：色情，Abuse：谩骂，Ad：广告，Custom：自定义词库。
	// 以及其他其他令人反感、不安全或不适宜的内容类型。
	Label *string `json:"Label,omitempty" name:"Label"`

	// 自定义标签
	// 注意：此字段可能返回 null，表示取不到有效值。
	Tag *string `json:"Tag,omitempty" name:"Tag"`

	// 命中的模型分值
	Score *int64 `json:"Score,omitempty" name:"Score"`
}

type LibResult 

type LibResult struct {

	// 场景识别结果
	Scene *string `json:"Scene,omitempty" name:"Scene"`

	// 建议您拿到判断结果后的执行操作。
	// 建议值，Block：建议屏蔽，Review：建议复审，Pass：建议通过
	Suggestion *string `json:"Suggestion,omitempty" name:"Suggestion"`

	// 恶意标签，Normal：正常，Porn：色情，Abuse：谩骂，Ad：广告，Custom：自定义词库。
	// 以及其他令人反感、不安全或不适宜的内容类型。
	Label *string `json:"Label,omitempty" name:"Label"`

	// 子标签检测结果
	// 注意：此字段可能返回 null，表示取不到有效值。
	SubLabel *string `json:"SubLabel,omitempty" name:"SubLabel"`

	// 该标签模型命中的分值
	Score *int64 `json:"Score,omitempty" name:"Score"`

	// 黑白库结果明细
	// 注意：此字段可能返回 null，表示取不到有效值。
	Details []*LibDetail `json:"Details,omitempty" name:"Details" list`
}

type Location 

type Location struct {

	// 左上角横坐标
	X *float64 `json:"X,omitempty" name:"X"`

	// 左上角纵坐标
	Y *float64 `json:"Y,omitempty" name:"Y"`

	// 宽度
	Width *float64 `json:"Width,omitempty" name:"Width"`

	// 高度
	Height *float64 `json:"Height,omitempty" name:"Height"`

	// 检测框的旋转角度
	Rotate *float64 `json:"Rotate,omitempty" name:"Rotate"`
}

type ObjectDetail 

type ObjectDetail struct {

	// 序号
	Id *uint64 `json:"Id,omitempty" name:"Id"`

	// 标签名称
	Name *string `json:"Name,omitempty" name:"Name"`

	// 标签值，
	// 当标签为二维码时，表示URL地址，如Name为QrCode时，Value为"http//abc.com/aaa"
	Value *string `json:"Value,omitempty" name:"Value"`

	// 分数
	Score *uint64 `json:"Score,omitempty" name:"Score"`

	// 检测框坐标
	Location *Location `json:"Location,omitempty" name:"Location"`
}

type ObjectResult 

type ObjectResult struct {

	// 场景识别结果
	Scene *string `json:"Scene,omitempty" name:"Scene"`

	// 建议您拿到判断结果后的执行操作。
	// 建议值，Block：建议屏蔽，Review：建议复审，Pass：建议通过
	Suggestion *string `json:"Suggestion,omitempty" name:"Suggestion"`

	// 恶意标签，Normal：正常，Porn：色情，Abuse：谩骂，Ad：广告，Custom：自定义图片。
	// 以及其他令人反感、不安全或不适宜的内容类型。
	Label *string `json:"Label,omitempty" name:"Label"`

	// 子标签检测结果
	SubLabel *string `json:"SubLabel,omitempty" name:"SubLabel"`

	// 该标签模型命中的分值
	Score *uint64 `json:"Score,omitempty" name:"Score"`

	// 实体名称
	// 注意：此字段可能返回 null，表示取不到有效值。
	Names []*string `json:"Names,omitempty" name:"Names" list`

	// 实体检测结果明细
	// 注意：此字段可能返回 null，表示取不到有效值。
	Details []*ObjectDetail `json:"Details,omitempty" name:"Details" list`
}

type OcrResult 

type OcrResult struct {

	// 场景识别结果
	Scene *string `json:"Scene,omitempty" name:"Scene"`

	// 建议您拿到判断结果后的执行操作。
	// 建议值，Block：建议屏蔽，Review：建议复审，Pass：建议通过
	Suggestion *string `json:"Suggestion,omitempty" name:"Suggestion"`

	// 恶意标签，Normal：正常，Porn：色情，Abuse：谩骂，Ad：广告，Custom：自定义词库。
	// 以及其他令人反感、不安全或不适宜的内容类型。
	Label *string `json:"Label,omitempty" name:"Label"`

	// 子标签检测结果
	SubLabel *string `json:"SubLabel,omitempty" name:"SubLabel"`

	// 该标签模型命中的分值
	Score *uint64 `json:"Score,omitempty" name:"Score"`

	// ocr结果详情
	// 注意：此字段可能返回 null，表示取不到有效值。
	Details []*OcrTextDetail `json:"Details,omitempty" name:"Details" list`

	// ocr识别出的文本结果
	Text *string `json:"Text,omitempty" name:"Text"`
}

type OcrTextDetail 

type OcrTextDetail struct {

	// OCR文本内容
	Text *string `json:"Text,omitempty" name:"Text"`

	// 恶意标签，Normal：正常，Porn：色情，Abuse：谩骂，Ad：广告，Custom：自定义词库。
	// 以及其他令人反感、不安全或不适宜的内容类型。
	Label *string `json:"Label,omitempty" name:"Label"`

	// 仅当Label为Custom自定义关键词时有效，表示自定义库id
	LibId *string `json:"LibId,omitempty" name:"LibId"`

	// 仅当Label为Custom自定义关键词时有效，表示自定义库名称
	LibName *string `json:"LibName,omitempty" name:"LibName"`

	// 该标签下命中的关键词
	Keywords []*string `json:"Keywords,omitempty" name:"Keywords" list`

	// 该标签模型命中的分值
	Score *uint64 `json:"Score,omitempty" name:"Score"`

	// OCR位置
	Location *Location `json:"Location,omitempty" name:"Location"`

	// OCR文本识别置信度
	Rate *uint64 `json:"Rate,omitempty" name:"Rate"`
}

type User 

type User struct {

	// 业务用户ID 如填写，会根据账号历史恶意情况，判定消息有害结果，特别是有利于可疑恶意情况下的辅助判断。账号可以填写微信uin、QQ号、微信openid、QQopenid、字符串等。该字段和账号类别确定唯一账号。
	UserId *string `json:"UserId,omitempty" name:"UserId"`

	// 业务用户ID类型 "1-微信uin 2-QQ号 3-微信群uin 4-qq群号 5-微信openid 6-QQopenid 7-其它string"
	AccountType *string `json:"AccountType,omitempty" name:"AccountType"`

	// 用户昵称
	Nickname *string `json:"Nickname,omitempty" name:"Nickname"`

	// 性别 默认0 未知 1 男性 2 女性
	Gender *uint64 `json:"Gender,omitempty" name:"Gender"`

	// 年龄 默认0 未知
	Age *uint64 `json:"Age,omitempty" name:"Age"`

	// 用户等级，默认0 未知 1 低 2 中 3 高
	Level *uint64 `json:"Level,omitempty" name:"Level"`

	// 手机号
	Phone *string `json:"Phone,omitempty" name:"Phone"`

	// 用户简介，长度不超过5000字
	Desc *string `json:"Desc,omitempty" name:"Desc"`

	// 用户头像图片链接
	HeadUrl *string `json:"HeadUrl,omitempty" name:"HeadUrl"`
}

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.