v20210922

package
v1.0.941 Latest Latest
Warning

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

Go to latest
Published: Jun 12, 2024 License: Apache-2.0 Imports: 7 Imported by: 0

Documentation

Index

Constants

View Source
const (

	// CAM签名/鉴权错误。
	AUTHFAILURE = "AuthFailure"

	// DryRun 操作,代表请求将会是成功的,只是多传了 DryRun 参数。
	DRYRUNOPERATION = "DryRunOperation"

	// 操作失败。
	FAILEDOPERATION = "FailedOperation"

	// 内部错误。
	INTERNALERROR = "InternalError"

	// 参数错误。
	INVALIDPARAMETER = "InvalidParameter"

	// 参数取值错误。
	INVALIDPARAMETERVALUE = "InvalidParameterValue"

	// 超过配额限制。
	LIMITEXCEEDED = "LimitExceeded"

	// 缺少参数错误。
	MISSINGPARAMETER = "MissingParameter"

	// 操作被拒绝。
	OPERATIONDENIED = "OperationDenied"

	// 请求的次数超过了频率限制。
	REQUESTLIMITEXCEEDED = "RequestLimitExceeded"

	// 资源被占用。
	RESOURCEINUSE = "ResourceInUse"

	// 资源不足。
	RESOURCEINSUFFICIENT = "ResourceInsufficient"

	// 资源不存在。
	RESOURCENOTFOUND = "ResourceNotFound"

	// 资源不可用。
	RESOURCEUNAVAILABLE = "ResourceUnavailable"

	// 资源售罄。
	RESOURCESSOLDOUT = "ResourcesSoldOut"

	// 未授权操作。
	UNAUTHORIZEDOPERATION = "UnauthorizedOperation"

	// 未开通权限/无有效套餐包/账号已欠费。
	UNAUTHORIZEDOPERATION_UNAUTHORIZED = "UnauthorizedOperation.Unauthorized"

	// 未知参数错误。
	UNKNOWNPARAMETER = "UnknownParameter"

	// 操作不支持。
	UNSUPPORTEDOPERATION = "UnsupportedOperation"
)
View Source
const APIVersion = "2021-09-22"

Variables

This section is empty.

Functions

This section is empty.

Types

type AudioResult

type AudioResult struct {
	// 该字段用于返回审核内容是否命中审核模型;取值:0(**未命中**)、1(**命中**)。
	// 注意:此字段可能返回 null,表示取不到有效值。
	HitFlag *int64 `json:"HitFlag,omitnil,omitempty" name:"HitFlag"`

	// 该字段用于返回检测结果所对应的恶意标签。<br>返回值:**Normal**:正常,**Porn**:色情,**Abuse**:谩骂,**Ad**:广告,**Custom**:自定义违规;以及其他令人反感、不安全或不适宜的内容类型。
	// 注意:此字段可能返回 null,表示取不到有效值。
	Label *string `json:"Label,omitnil,omitempty" name:"Label"`

	// 该字段用于返回后续操作建议。当您获取到判定结果后,返回值表示具体的后续建议操作。<br>
	// 返回值:**Block**:建议屏蔽,**Review** :建议人工复审,**Pass**:建议通过
	// 注意:此字段可能返回 null,表示取不到有效值。
	Suggestion *string `json:"Suggestion,omitnil,omitempty" name:"Suggestion"`

	// 该字段用于返回当前标签下的置信度,取值范围:0(**置信度最低**)-100(**置信度最高** ),越高代表文本越有可能属于当前返回的标签;如:*色情 99*,则表明该文本非常有可能属于色情内容。
	// 注意:此字段可能返回 null,表示取不到有效值。
	Score *int64 `json:"Score,omitnil,omitempty" name:"Score"`

	// 该字段用于返回音频文件经ASR识别后的文本信息。最长可识别**5小时**的音频文件,若超出时长限制,接口将会报错。
	// 注意:此字段可能返回 null,表示取不到有效值。
	Text *string `json:"Text,omitnil,omitempty" name:"Text"`

	// 该字段用于返回音频片段存储的链接地址,该地址有效期为1天。
	// 注意:此字段可能返回 null,表示取不到有效值。
	Url *string `json:"Url,omitnil,omitempty" name:"Url"`

	// 该字段用于返回音频文件的时长,单位为毫秒。
	// 注意:此字段可能返回 null,表示取不到有效值。
	Duration *string `json:"Duration,omitnil,omitempty" name:"Duration"`

	// 该字段用于返回输入参数中的额外附加信息(Extra),如未配置则默认返回值为空。<br>备注:不同客户或Biztype下返回信息不同,如需配置该字段请提交工单咨询或联系售后专员处理。
	// 注意:此字段可能返回 null,表示取不到有效值。
	Extra *string `json:"Extra,omitnil,omitempty" name:"Extra"`

	// 该字段用于返回音频文件经ASR识别后产生的文本的详细审核结果。具体结果内容请参见AudioResultDetailLanguageResult数据结构的细节描述。
	// 注意:此字段可能返回 null,表示取不到有效值。
	TextResults []*AudioResultDetailTextResult `json:"TextResults,omitnil,omitempty" name:"TextResults"`

	// 该字段用于返回音频文件呻吟检测的详细审核结果。具体结果内容请参见AudioResultDetailMoanResult数据结构的细节描述。
	// 注意:此字段可能返回 null,表示取不到有效值。
	MoanResults []*AudioResultDetailMoanResult `json:"MoanResults,omitnil,omitempty" name:"MoanResults"`

	// 该字段用于返回音频小语种检测的详细审核结果。具体结果内容请参见AudioResultDetailLanguageResult数据结构的细节描述。
	// 注意:此字段可能返回 null,表示取不到有效值。
	LanguageResults []*AudioResultDetailLanguageResult `json:"LanguageResults,omitnil,omitempty" name:"LanguageResults"`

	// 该字段用于返回当前标签(Lable)下的二级标签。
	// 注意:此字段可能返回 null,表示取不到有效值。
	SubLabel *string `json:"SubLabel,omitnil,omitempty" name:"SubLabel"`

	// 识别类标签结果信息列表
	// 注意:此字段可能返回 null,表示取不到有效值。
	RecognitionResults []*RecognitionResult `json:"RecognitionResults,omitnil,omitempty" name:"RecognitionResults"`
}

type AudioResultDetailLanguageResult

type AudioResultDetailLanguageResult struct {
	// 语种
	// 注意:此字段可能返回 null,表示取不到有效值。
	Label *string `json:"Label,omitnil,omitempty" name:"Label"`

	// 得分
	// 注意:此字段可能返回 null,表示取不到有效值。
	Score *int64 `json:"Score,omitnil,omitempty" name:"Score"`

	// 开始时间
	// 注意:此字段可能返回 null,表示取不到有效值。
	StartTime *float64 `json:"StartTime,omitnil,omitempty" name:"StartTime"`

	// 结束时间
	// 注意:此字段可能返回 null,表示取不到有效值。
	EndTime *float64 `json:"EndTime,omitnil,omitempty" name:"EndTime"`

	// 子标签码
	// 注意:此字段可能返回 null,表示取不到有效值。
	SubLabelCode *string `json:"SubLabelCode,omitnil,omitempty" name:"SubLabelCode"`
}

type AudioResultDetailMoanResult

type AudioResultDetailMoanResult struct {
	// 该字段用于返回检测结果需要检测的内容类型,此处固定为**Moan**(呻吟)以调用呻吟检测功能。
	// 注意:此字段可能返回 null,表示取不到有效值。
	Label *string `json:"Label,omitnil,omitempty" name:"Label"`

	// 该字段用于返回呻吟检测的置信度,取值范围:0(**置信度最低**)-100(**置信度最高**),越高代表音频越有可能属于呻吟内容。
	Score *int64 `json:"Score,omitnil,omitempty" name:"Score"`

	// 该字段用于返回对应呻吟标签的片段在音频文件内的开始时间,单位为毫秒。
	StartTime *float64 `json:"StartTime,omitnil,omitempty" name:"StartTime"`

	// 该字段用于返回对应呻吟标签的片段在音频文件内的结束时间,单位为毫秒。
	EndTime *float64 `json:"EndTime,omitnil,omitempty" name:"EndTime"`

	// *内测中,敬请期待*
	SubLabelCode *string `json:"SubLabelCode,omitnil,omitempty" name:"SubLabelCode"`

	// 该字段用于返回当前标签(Lable)下的二级标签。
	SubLabel *string `json:"SubLabel,omitnil,omitempty" name:"SubLabel"`

	// 该字段用于返回基于恶意标签的后续操作建议。当您获取到判定结果后,返回值表示系统推荐的后续操作;建议您按照业务所需,对不同违规类型与建议值进行处理。<br>返回值:**Block**:建议屏蔽,**Review** :建议人工复审,**Pass**:建议通过
	Suggestion *string `json:"Suggestion,omitnil,omitempty" name:"Suggestion"`
}

type AudioResultDetailTextResult

type AudioResultDetailTextResult struct {
	// 该字段用于返回检测结果所对应的恶意标签。<br>返回值:**Normal**:正常,**Porn**:色情,**Abuse**:谩骂,**Ad**:广告,**Custom**:自定义违规;以及其他令人反感、不安全或不适宜的内容类型。
	// 注意:此字段可能返回 null,表示取不到有效值。
	Label *string `json:"Label,omitnil,omitempty" name:"Label"`

	// 该字段用于返回ASR识别出的文本内容命中的关键词信息,用于标注内容违规的具体原因(如:加我微信)。该参数可能会有多个返回值,代表命中的多个关键词;若返回值为空,Score不为空,则代表识别结果所对应的恶意标签(Label)来自于语义模型判断的返回值。
	// 注意:此字段可能返回 null,表示取不到有效值。
	Keywords []*string `json:"Keywords,omitnil,omitempty" name:"Keywords"`

	// 该字段**仅当Label为Custom:自定义关键词时该参数有效**,用于返回自定义库的ID,以方便自定义库管理和配置。
	// 注意:此字段可能返回 null,表示取不到有效值。
	LibId *string `json:"LibId,omitnil,omitempty" name:"LibId"`

	// 该字段**仅当Label为Custom:自定义关键词时该参数有效**,用于返回自定义库的名称,以方便自定义库管理和配置。
	// 注意:此字段可能返回 null,表示取不到有效值。
	LibName *string `json:"LibName,omitnil,omitempty" name:"LibName"`

	// 该字段用于返回当前标签下的置信度,取值范围:0(**置信度最低**)-100(**置信度最高**),越高代表文本越有可能属于当前返回的标签;如:*色情 99*,则表明该文本非常有可能属于色情内容。
	// 注意:此字段可能返回 null,表示取不到有效值。
	Score *int64 `json:"Score,omitnil,omitempty" name:"Score"`

	// 该字段用于返回自定义关键词对应的词库类型,取值为**1**(黑白库)和**2**(自定义关键词库),若未配置自定义关键词库,则默认值为1(黑白库匹配)。
	// 注意:此字段可能返回 null,表示取不到有效值。
	LibType *int64 `json:"LibType,omitnil,omitempty" name:"LibType"`

	// 该字段用于返回后续操作建议。当您获取到判定结果后,返回值表示具体的后续建议操作。<br>
	// 返回值:**Block**:建议屏蔽,**Review** :建议人工复审,**Pass**:建议通过
	// 注意:此字段可能返回 null,表示取不到有效值。
	Suggestion *string `json:"Suggestion,omitnil,omitempty" name:"Suggestion"`

	// 该字段用于返回当前标签(Lable)下的二级标签。
	// 注意:此字段可能返回 null,表示取不到有效值。
	SubLabel *string `json:"SubLabel,omitnil,omitempty" name:"SubLabel"`
}

type AudioSegments

type AudioSegments struct {
	// 截帧时间。
	// 点播文件:该值为相对于视频偏移时间,单位为秒,例如:0,5,10
	// 直播流:该值为时间戳,例如:1594650717
	// 注意:此字段可能返回 null,表示取不到有效值。
	OffsetTime *string `json:"OffsetTime,omitnil,omitempty" name:"OffsetTime"`

	// 结果集
	// 注意:此字段可能返回 null,表示取不到有效值。
	Result *AudioResult `json:"Result,omitnil,omitempty" name:"Result"`
}

type BucketInfo

type BucketInfo struct {
	// 腾讯云对象存储,存储桶名称
	Bucket *string `json:"Bucket,omitnil,omitempty" name:"Bucket"`

	// 地域
	Region *string `json:"Region,omitnil,omitempty" name:"Region"`

	// 对象Key
	Object *string `json:"Object,omitnil,omitempty" name:"Object"`
}

type CancelTaskRequest

type CancelTaskRequest struct {
	*tchttp.BaseRequest

	// 任务ID
	TaskId *string `json:"TaskId,omitnil,omitempty" name:"TaskId"`
}

func NewCancelTaskRequest

func NewCancelTaskRequest() (request *CancelTaskRequest)

func (*CancelTaskRequest) FromJsonString

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

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

func (*CancelTaskRequest) ToJsonString

func (r *CancelTaskRequest) ToJsonString() string

type CancelTaskRequestParams

type CancelTaskRequestParams struct {
	// 任务ID
	TaskId *string `json:"TaskId,omitnil,omitempty" name:"TaskId"`
}

Predefined struct for user

type CancelTaskResponse

type CancelTaskResponse struct {
	*tchttp.BaseResponse
	Response *CancelTaskResponseParams `json:"Response"`
}

func NewCancelTaskResponse

func NewCancelTaskResponse() (response *CancelTaskResponse)

func (*CancelTaskResponse) FromJsonString

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

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

func (*CancelTaskResponse) ToJsonString

func (r *CancelTaskResponse) ToJsonString() string

type CancelTaskResponseParams

type CancelTaskResponseParams struct {
	// 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
	RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"`
}

Predefined struct for user

type Client

type Client struct {
	common.Client
}

func NewClient

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

func NewClientWithSecretId

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

Deprecated

func (*Client) CancelTask

func (c *Client) CancelTask(request *CancelTaskRequest) (response *CancelTaskResponse, err error)

CancelTask 可使用该接口取消审核任务,成功取消后,该接口返回已取消任务的TaskId。

可能返回的错误码:

DRYRUNOPERATION = "DryRunOperation"
FAILEDOPERATION = "FailedOperation"
INVALIDPARAMETER = "InvalidParameter"
INVALIDPARAMETERVALUE = "InvalidParameterValue"
LIMITEXCEEDED = "LimitExceeded"
MISSINGPARAMETER = "MissingParameter"
OPERATIONDENIED = "OperationDenied"
REQUESTLIMITEXCEEDED = "RequestLimitExceeded"
RESOURCEINUSE = "ResourceInUse"
RESOURCEINSUFFICIENT = "ResourceInsufficient"
RESOURCENOTFOUND = "ResourceNotFound"
RESOURCEUNAVAILABLE = "ResourceUnavailable"
RESOURCESSOLDOUT = "ResourcesSoldOut"
UNAUTHORIZEDOPERATION = "UnauthorizedOperation"
UNKNOWNPARAMETER = "UnknownParameter"
UNSUPPORTEDOPERATION = "UnsupportedOperation"

func (*Client) CancelTaskWithContext

func (c *Client) CancelTaskWithContext(ctx context.Context, request *CancelTaskRequest) (response *CancelTaskResponse, err error)

CancelTask 可使用该接口取消审核任务,成功取消后,该接口返回已取消任务的TaskId。

可能返回的错误码:

DRYRUNOPERATION = "DryRunOperation"
FAILEDOPERATION = "FailedOperation"
INVALIDPARAMETER = "InvalidParameter"
INVALIDPARAMETERVALUE = "InvalidParameterValue"
LIMITEXCEEDED = "LimitExceeded"
MISSINGPARAMETER = "MissingParameter"
OPERATIONDENIED = "OperationDenied"
REQUESTLIMITEXCEEDED = "RequestLimitExceeded"
RESOURCEINUSE = "ResourceInUse"
RESOURCEINSUFFICIENT = "ResourceInsufficient"
RESOURCENOTFOUND = "ResourceNotFound"
RESOURCEUNAVAILABLE = "ResourceUnavailable"
RESOURCESSOLDOUT = "ResourcesSoldOut"
UNAUTHORIZEDOPERATION = "UnauthorizedOperation"
UNKNOWNPARAMETER = "UnknownParameter"
UNSUPPORTEDOPERATION = "UnsupportedOperation"

func (*Client) CreateVideoModerationTask

func (c *Client) CreateVideoModerationTask(request *CreateVideoModerationTaskRequest) (response *CreateVideoModerationTaskResponse, err error)

CreateVideoModerationTask 本接口(Video Moderation System,VM)用于提交视频文件或视频流进行智能审核任务。使用前请您使用腾讯云主账号登录控制台[开通视频内容安全服务](https://console.cloud.tencent.com/cms)并调整好对应的业务配置。<br>

### 功能使用说明:

- 前往“[内容安全控制台-视频内容安全](https://console.cloud.tencent.com/cms)”开启使用视频内容安全服务,首次开通服务的用户可免费领用试用套餐包,包含200分钟的处理量(换算1s每帧截图,赠送**12000张图**、**200分钟的音频**处理量),有效期为15天。

- 该接口为收费接口,计费方式敬请参见[腾讯云视频内容安全定价](https://cloud.tencent.com/product/vm/pricing)。

- 默认接口请求频率限制:**20次/秒**,对于异步审核任务(点播视频),超出频率限制的请求会自动排入待审核队列,对于同步审核任务(直播视频),超出频率限制将会报错。

- 默认并发审核路数限制:点播默认10路,异步审核任务(点播视频)数量超过并发审核路数时,将会进入排队;直播默认100路,同步审核任务(直播视频)超过并发审核路数,接口会返回错误。

### 接口功能说明:

- 支持对视频文件或视频流进行自动检测,从 OCR文本识别、物体检测(实体、广告台标、二维码等)、图像识别及音频审核四个维度,通过深度学习技术识别视频中的违规内容;

- 支持设置回调地址 Callback 获取检测结果,或通过接口(查看任务详情)主动轮询获取检测结果详情;对于正常审核中的视频任务,如含有违规内容,则截帧图片最长会在**3s**内回调,音频片段会在用户配置的**切片时长 + 2s**内回调;对于在队列中的待审核任务,回调时间为正常审核回调时间+等待时间;

- 支持通过接口(查看审核任务列表)查询任务队列,用户可根据多种业务信息(业务类型、审核结果、任务状态等)筛选审核任务列表;

- 支持识别多种违规场景,包括:低俗、谩骂、色情、广告等场景;

- 支持根据不同的业务场景配置自定义的审核策略;

- 支持用户自定义配置黑白词库及图片库,打击自定义违规内容(目前仅支持黑名单配置);

- 支持用户自定义配置审核任务优先级,当有多个任务排队时,可根据用户配置自动调整任务优先级;

- 支持批量提交检测任务,**最多可同时创建10个任务**;

### 视频文件调用说明:

- 视频文件大小支持:**4K视频文件 < 10GB**;**低于4K视频文件 < 5GB**

- 视频文件分辨率支持:**最佳分辨率为1920x1080 (1080p)**,如果视频文件小于300MB,则分辨率可以大于1080p,分辨率最大支持4K,更大视频可以调用[云转码服务](https://cloud.tencent.com/product/mps/details)转码后再送审;

- 视频文件支持格式:flv、mkv 、mp4 、rmvb 、avi 、wmv、3gp、ts、mov、rm、mpeg、wmf等。

- 视频文件支持的访问方式:链接地址(支持HTTP/HTTPS)、腾讯云COS存储;

- 若传入视频文件的访问链接,则需要注意视频**头文件的读取时间限制为3秒**,为保障被检测视频的稳定性和可靠性,建议您使用腾讯云COS存储或者CDN缓存等;

- 支持用户配置是否需要开启音频审核,若不开启则将仅对视频文件图像内容进行审核。

### 视频流调用说明:

- 视频流时长支持:**8小时以内**

- 视频流分辨率支持:支持**1920x1080 (1080p)**,更高分辨率视频可以调用[直播云转码服务](https://cloud.tencent.com/document/product/267/39889)转码后再送审;

- 视频流支持格式:rmtp,flv 等主流视频流编码格式。

- 视频流支持的传输协议:HTTP/HTTPS/RTMP;

- 支持用户配置是否需要开启音频审核,若不开启则将仅对视频流图像内容进行审核。

### 直播断流处理说明:

- 请确认已对接[取消任务](https://cloud.tencent.com/document/product/1265/80018)。

- 如果直播任务取消/结束,则终止直播拉流并退出审核。

- 如果直播任务没有取消/结束,直播视频推流因故中断,产品将在将在10分钟内持续拉流重试。如果10分钟检测到图片截帧/音频切片数据,则恢复正常审核,反之,则终止拉流并退出审核。在拉流终止后,用户如有审核需求,需重新送审。

可能返回的错误码:

DRYRUNOPERATION = "DryRunOperation"
FAILEDOPERATION = "FailedOperation"
INTERNALERROR = "InternalError"
INVALIDPARAMETER = "InvalidParameter"
INVALIDPARAMETERVALUE = "InvalidParameterValue"
LIMITEXCEEDED = "LimitExceeded"
MISSINGPARAMETER = "MissingParameter"
OPERATIONDENIED = "OperationDenied"
REQUESTLIMITEXCEEDED = "RequestLimitExceeded"
RESOURCEINUSE = "ResourceInUse"
RESOURCEINSUFFICIENT = "ResourceInsufficient"
RESOURCENOTFOUND = "ResourceNotFound"
RESOURCEUNAVAILABLE = "ResourceUnavailable"
RESOURCESSOLDOUT = "ResourcesSoldOut"
UNAUTHORIZEDOPERATION = "UnauthorizedOperation"
UNAUTHORIZEDOPERATION_UNAUTHORIZED = "UnauthorizedOperation.Unauthorized"
UNKNOWNPARAMETER = "UnknownParameter"
UNSUPPORTEDOPERATION = "UnsupportedOperation"

func (*Client) CreateVideoModerationTaskWithContext

func (c *Client) CreateVideoModerationTaskWithContext(ctx context.Context, request *CreateVideoModerationTaskRequest) (response *CreateVideoModerationTaskResponse, err error)

CreateVideoModerationTask 本接口(Video Moderation System,VM)用于提交视频文件或视频流进行智能审核任务。使用前请您使用腾讯云主账号登录控制台[开通视频内容安全服务](https://console.cloud.tencent.com/cms)并调整好对应的业务配置。<br>

### 功能使用说明:

- 前往“[内容安全控制台-视频内容安全](https://console.cloud.tencent.com/cms)”开启使用视频内容安全服务,首次开通服务的用户可免费领用试用套餐包,包含200分钟的处理量(换算1s每帧截图,赠送**12000张图**、**200分钟的音频**处理量),有效期为15天。

- 该接口为收费接口,计费方式敬请参见[腾讯云视频内容安全定价](https://cloud.tencent.com/product/vm/pricing)。

- 默认接口请求频率限制:**20次/秒**,对于异步审核任务(点播视频),超出频率限制的请求会自动排入待审核队列,对于同步审核任务(直播视频),超出频率限制将会报错。

- 默认并发审核路数限制:点播默认10路,异步审核任务(点播视频)数量超过并发审核路数时,将会进入排队;直播默认100路,同步审核任务(直播视频)超过并发审核路数,接口会返回错误。

### 接口功能说明:

- 支持对视频文件或视频流进行自动检测,从 OCR文本识别、物体检测(实体、广告台标、二维码等)、图像识别及音频审核四个维度,通过深度学习技术识别视频中的违规内容;

- 支持设置回调地址 Callback 获取检测结果,或通过接口(查看任务详情)主动轮询获取检测结果详情;对于正常审核中的视频任务,如含有违规内容,则截帧图片最长会在**3s**内回调,音频片段会在用户配置的**切片时长 + 2s**内回调;对于在队列中的待审核任务,回调时间为正常审核回调时间+等待时间;

- 支持通过接口(查看审核任务列表)查询任务队列,用户可根据多种业务信息(业务类型、审核结果、任务状态等)筛选审核任务列表;

- 支持识别多种违规场景,包括:低俗、谩骂、色情、广告等场景;

- 支持根据不同的业务场景配置自定义的审核策略;

- 支持用户自定义配置黑白词库及图片库,打击自定义违规内容(目前仅支持黑名单配置);

- 支持用户自定义配置审核任务优先级,当有多个任务排队时,可根据用户配置自动调整任务优先级;

- 支持批量提交检测任务,**最多可同时创建10个任务**;

### 视频文件调用说明:

- 视频文件大小支持:**4K视频文件 < 10GB**;**低于4K视频文件 < 5GB**

- 视频文件分辨率支持:**最佳分辨率为1920x1080 (1080p)**,如果视频文件小于300MB,则分辨率可以大于1080p,分辨率最大支持4K,更大视频可以调用[云转码服务](https://cloud.tencent.com/product/mps/details)转码后再送审;

- 视频文件支持格式:flv、mkv 、mp4 、rmvb 、avi 、wmv、3gp、ts、mov、rm、mpeg、wmf等。

- 视频文件支持的访问方式:链接地址(支持HTTP/HTTPS)、腾讯云COS存储;

- 若传入视频文件的访问链接,则需要注意视频**头文件的读取时间限制为3秒**,为保障被检测视频的稳定性和可靠性,建议您使用腾讯云COS存储或者CDN缓存等;

- 支持用户配置是否需要开启音频审核,若不开启则将仅对视频文件图像内容进行审核。

### 视频流调用说明:

- 视频流时长支持:**8小时以内**

- 视频流分辨率支持:支持**1920x1080 (1080p)**,更高分辨率视频可以调用[直播云转码服务](https://cloud.tencent.com/document/product/267/39889)转码后再送审;

- 视频流支持格式:rmtp,flv 等主流视频流编码格式。

- 视频流支持的传输协议:HTTP/HTTPS/RTMP;

- 支持用户配置是否需要开启音频审核,若不开启则将仅对视频流图像内容进行审核。

### 直播断流处理说明:

- 请确认已对接[取消任务](https://cloud.tencent.com/document/product/1265/80018)。

- 如果直播任务取消/结束,则终止直播拉流并退出审核。

- 如果直播任务没有取消/结束,直播视频推流因故中断,产品将在将在10分钟内持续拉流重试。如果10分钟检测到图片截帧/音频切片数据,则恢复正常审核,反之,则终止拉流并退出审核。在拉流终止后,用户如有审核需求,需重新送审。

可能返回的错误码:

DRYRUNOPERATION = "DryRunOperation"
FAILEDOPERATION = "FailedOperation"
INTERNALERROR = "InternalError"
INVALIDPARAMETER = "InvalidParameter"
INVALIDPARAMETERVALUE = "InvalidParameterValue"
LIMITEXCEEDED = "LimitExceeded"
MISSINGPARAMETER = "MissingParameter"
OPERATIONDENIED = "OperationDenied"
REQUESTLIMITEXCEEDED = "RequestLimitExceeded"
RESOURCEINUSE = "ResourceInUse"
RESOURCEINSUFFICIENT = "ResourceInsufficient"
RESOURCENOTFOUND = "ResourceNotFound"
RESOURCEUNAVAILABLE = "ResourceUnavailable"
RESOURCESSOLDOUT = "ResourcesSoldOut"
UNAUTHORIZEDOPERATION = "UnauthorizedOperation"
UNAUTHORIZEDOPERATION_UNAUTHORIZED = "UnauthorizedOperation.Unauthorized"
UNKNOWNPARAMETER = "UnknownParameter"
UNSUPPORTEDOPERATION = "UnsupportedOperation"

func (*Client) DescribeTaskDetail

func (c *Client) DescribeTaskDetail(request *DescribeTaskDetailRequest) (response *DescribeTaskDetailResponse, err error)

DescribeTaskDetail 通过查看任务详情 DescribeTaskDetail 接口,可主动轮询获取检测结果详情。

可能返回的错误码:

DRYRUNOPERATION = "DryRunOperation"
FAILEDOPERATION = "FailedOperation"
INTERNALERROR = "InternalError"
INVALIDPARAMETER = "InvalidParameter"
INVALIDPARAMETERVALUE = "InvalidParameterValue"
LIMITEXCEEDED = "LimitExceeded"
MISSINGPARAMETER = "MissingParameter"
OPERATIONDENIED = "OperationDenied"
REQUESTLIMITEXCEEDED = "RequestLimitExceeded"
RESOURCEINUSE = "ResourceInUse"
RESOURCEINSUFFICIENT = "ResourceInsufficient"
RESOURCENOTFOUND = "ResourceNotFound"
RESOURCEUNAVAILABLE = "ResourceUnavailable"
RESOURCESSOLDOUT = "ResourcesSoldOut"
UNAUTHORIZEDOPERATION = "UnauthorizedOperation"
UNKNOWNPARAMETER = "UnknownParameter"
UNSUPPORTEDOPERATION = "UnsupportedOperation"

func (*Client) DescribeTaskDetailWithContext

func (c *Client) DescribeTaskDetailWithContext(ctx context.Context, request *DescribeTaskDetailRequest) (response *DescribeTaskDetailResponse, err error)

DescribeTaskDetail 通过查看任务详情 DescribeTaskDetail 接口,可主动轮询获取检测结果详情。

可能返回的错误码:

DRYRUNOPERATION = "DryRunOperation"
FAILEDOPERATION = "FailedOperation"
INTERNALERROR = "InternalError"
INVALIDPARAMETER = "InvalidParameter"
INVALIDPARAMETERVALUE = "InvalidParameterValue"
LIMITEXCEEDED = "LimitExceeded"
MISSINGPARAMETER = "MissingParameter"
OPERATIONDENIED = "OperationDenied"
REQUESTLIMITEXCEEDED = "RequestLimitExceeded"
RESOURCEINUSE = "ResourceInUse"
RESOURCEINSUFFICIENT = "ResourceInsufficient"
RESOURCENOTFOUND = "ResourceNotFound"
RESOURCEUNAVAILABLE = "ResourceUnavailable"
RESOURCESSOLDOUT = "ResourcesSoldOut"
UNAUTHORIZEDOPERATION = "UnauthorizedOperation"
UNKNOWNPARAMETER = "UnknownParameter"
UNSUPPORTEDOPERATION = "UnsupportedOperation"

func (*Client) DescribeTasks

func (c *Client) DescribeTasks(request *DescribeTasksRequest) (response *DescribeTasksResponse, err error)

DescribeTasks 通过查看审核任务列表接口,可查询任务队列;您可根据多种业务信息(业务类型、审核结果、任务状态等)筛选审核任务列表。

可能返回的错误码:

AUTHFAILURE = "AuthFailure"
DRYRUNOPERATION = "DryRunOperation"
FAILEDOPERATION = "FailedOperation"
INTERNALERROR = "InternalError"
INVALIDPARAMETER = "InvalidParameter"
INVALIDPARAMETERVALUE = "InvalidParameterValue"
LIMITEXCEEDED = "LimitExceeded"
MISSINGPARAMETER = "MissingParameter"
OPERATIONDENIED = "OperationDenied"
REQUESTLIMITEXCEEDED = "RequestLimitExceeded"
RESOURCEINUSE = "ResourceInUse"
RESOURCEINSUFFICIENT = "ResourceInsufficient"
RESOURCENOTFOUND = "ResourceNotFound"
RESOURCEUNAVAILABLE = "ResourceUnavailable"
RESOURCESSOLDOUT = "ResourcesSoldOut"
UNAUTHORIZEDOPERATION = "UnauthorizedOperation"
UNKNOWNPARAMETER = "UnknownParameter"
UNSUPPORTEDOPERATION = "UnsupportedOperation"

func (*Client) DescribeTasksWithContext

func (c *Client) DescribeTasksWithContext(ctx context.Context, request *DescribeTasksRequest) (response *DescribeTasksResponse, err error)

DescribeTasks 通过查看审核任务列表接口,可查询任务队列;您可根据多种业务信息(业务类型、审核结果、任务状态等)筛选审核任务列表。

可能返回的错误码:

AUTHFAILURE = "AuthFailure"
DRYRUNOPERATION = "DryRunOperation"
FAILEDOPERATION = "FailedOperation"
INTERNALERROR = "InternalError"
INVALIDPARAMETER = "InvalidParameter"
INVALIDPARAMETERVALUE = "InvalidParameterValue"
LIMITEXCEEDED = "LimitExceeded"
MISSINGPARAMETER = "MissingParameter"
OPERATIONDENIED = "OperationDenied"
REQUESTLIMITEXCEEDED = "RequestLimitExceeded"
RESOURCEINUSE = "ResourceInUse"
RESOURCEINSUFFICIENT = "ResourceInsufficient"
RESOURCENOTFOUND = "ResourceNotFound"
RESOURCEUNAVAILABLE = "ResourceUnavailable"
RESOURCESSOLDOUT = "ResourcesSoldOut"
UNAUTHORIZEDOPERATION = "UnauthorizedOperation"
UNKNOWNPARAMETER = "UnknownParameter"
UNSUPPORTEDOPERATION = "UnsupportedOperation"

type CreateVideoModerationTaskRequest

type CreateVideoModerationTaskRequest struct {
	*tchttp.BaseRequest

	// 该字段表示策略的具体编号,用于接口调度,在[内容安全控制台](https://console.cloud.tencent.com/cms/clouds/manage)中可配置。若不传入Biztype参数(留空),则代表采用默认的识别策略;传入则会在审核时根据业务场景采取不同的审核策略。
	// 备注:Biztype仅为数字、字母与下划线的组合,长度为3-32个字符;不同Biztype关联不同的业务场景与识别能力策略,调用前请确认正确的Biztype。
	BizType *string `json:"BizType,omitnil,omitempty" name:"BizType"`

	// 任务类型:可选VIDEO(点播视频),LIVE_VIDEO(直播视频)
	Type *string `json:"Type,omitnil,omitempty" name:"Type"`

	// 输入的任务信息,最多可以同时创建10个任务
	Tasks []*TaskInput `json:"Tasks,omitnil,omitempty" name:"Tasks"`

	// 验证签名参数,具体可以参考[验签说明](https://cloud.tencent.com/document/product/1265/104001#42dd87d2-580f-46cf-a953-639a787d1eda)。
	Seed *string `json:"Seed,omitnil,omitempty" name:"Seed"`

	// 接收审核信息回调地址。如果设置了该字段,在审核过程中发现违规音频片段和画面截帧结果将发送至该接口。更多详情请参阅[回调配置说明](https://cloud.tencent.com/document/product/1265/104001)。
	CallbackUrl *string `json:"CallbackUrl,omitnil,omitempty" name:"CallbackUrl"`

	// 审核排队优先级。当您有多个视频审核任务排队时,可以根据这个参数控制排队优先级。用于处理插队等逻辑。默认该参数为0
	Priority *int64 `json:"Priority,omitnil,omitempty" name:"Priority"`

	// 该字段表示待检测对象对应的用户相关信息,若填入则可甄别相应违规风险用户
	User *User `json:"User,omitnil,omitempty" name:"User"`
}

func NewCreateVideoModerationTaskRequest

func NewCreateVideoModerationTaskRequest() (request *CreateVideoModerationTaskRequest)

func (*CreateVideoModerationTaskRequest) FromJsonString

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

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

func (*CreateVideoModerationTaskRequest) ToJsonString

func (r *CreateVideoModerationTaskRequest) ToJsonString() string

type CreateVideoModerationTaskRequestParams

type CreateVideoModerationTaskRequestParams struct {
	// 该字段表示策略的具体编号,用于接口调度,在[内容安全控制台](https://console.cloud.tencent.com/cms/clouds/manage)中可配置。若不传入Biztype参数(留空),则代表采用默认的识别策略;传入则会在审核时根据业务场景采取不同的审核策略。
	// 备注:Biztype仅为数字、字母与下划线的组合,长度为3-32个字符;不同Biztype关联不同的业务场景与识别能力策略,调用前请确认正确的Biztype。
	BizType *string `json:"BizType,omitnil,omitempty" name:"BizType"`

	// 任务类型:可选VIDEO(点播视频),LIVE_VIDEO(直播视频)
	Type *string `json:"Type,omitnil,omitempty" name:"Type"`

	// 输入的任务信息,最多可以同时创建10个任务
	Tasks []*TaskInput `json:"Tasks,omitnil,omitempty" name:"Tasks"`

	// 验证签名参数,具体可以参考[验签说明](https://cloud.tencent.com/document/product/1265/104001#42dd87d2-580f-46cf-a953-639a787d1eda)。
	Seed *string `json:"Seed,omitnil,omitempty" name:"Seed"`

	// 接收审核信息回调地址。如果设置了该字段,在审核过程中发现违规音频片段和画面截帧结果将发送至该接口。更多详情请参阅[回调配置说明](https://cloud.tencent.com/document/product/1265/104001)。
	CallbackUrl *string `json:"CallbackUrl,omitnil,omitempty" name:"CallbackUrl"`

	// 审核排队优先级。当您有多个视频审核任务排队时,可以根据这个参数控制排队优先级。用于处理插队等逻辑。默认该参数为0
	Priority *int64 `json:"Priority,omitnil,omitempty" name:"Priority"`

	// 该字段表示待检测对象对应的用户相关信息,若填入则可甄别相应违规风险用户
	User *User `json:"User,omitnil,omitempty" name:"User"`
}

Predefined struct for user

type CreateVideoModerationTaskResponse

type CreateVideoModerationTaskResponse struct {
	*tchttp.BaseResponse
	Response *CreateVideoModerationTaskResponseParams `json:"Response"`
}

func NewCreateVideoModerationTaskResponse

func NewCreateVideoModerationTaskResponse() (response *CreateVideoModerationTaskResponse)

func (*CreateVideoModerationTaskResponse) FromJsonString

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

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

func (*CreateVideoModerationTaskResponse) ToJsonString

func (r *CreateVideoModerationTaskResponse) ToJsonString() string

type CreateVideoModerationTaskResponseParams

type CreateVideoModerationTaskResponseParams struct {
	// 任务创建结果
	// 注意:此字段可能返回 null,表示取不到有效值。
	Results []*TaskResult `json:"Results,omitnil,omitempty" name:"Results"`

	// 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
	RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"`
}

Predefined struct for user

type DescribeTaskDetailRequest

type DescribeTaskDetailRequest struct {
	*tchttp.BaseRequest

	// 任务ID,创建任务后返回的TaskId字段
	TaskId *string `json:"TaskId,omitnil,omitempty" name:"TaskId"`

	// 是否展示所有分片,默认只展示命中规则的分片
	ShowAllSegments *bool `json:"ShowAllSegments,omitnil,omitempty" name:"ShowAllSegments"`
}

func NewDescribeTaskDetailRequest

func NewDescribeTaskDetailRequest() (request *DescribeTaskDetailRequest)

func (*DescribeTaskDetailRequest) FromJsonString

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

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

func (*DescribeTaskDetailRequest) ToJsonString

func (r *DescribeTaskDetailRequest) ToJsonString() string

type DescribeTaskDetailRequestParams

type DescribeTaskDetailRequestParams struct {
	// 任务ID,创建任务后返回的TaskId字段
	TaskId *string `json:"TaskId,omitnil,omitempty" name:"TaskId"`

	// 是否展示所有分片,默认只展示命中规则的分片
	ShowAllSegments *bool `json:"ShowAllSegments,omitnil,omitempty" name:"ShowAllSegments"`
}

Predefined struct for user

type DescribeTaskDetailResponse

type DescribeTaskDetailResponse struct {
	*tchttp.BaseResponse
	Response *DescribeTaskDetailResponseParams `json:"Response"`
}

func NewDescribeTaskDetailResponse

func NewDescribeTaskDetailResponse() (response *DescribeTaskDetailResponse)

func (*DescribeTaskDetailResponse) FromJsonString

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

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

func (*DescribeTaskDetailResponse) ToJsonString

func (r *DescribeTaskDetailResponse) ToJsonString() string

type DescribeTaskDetailResponseParams

type DescribeTaskDetailResponseParams struct {
	// 该字段用于返回创建视频审核任务后返回的任务ID(在Results参数中),用于标识需要查询任务详情的审核任务。
	// 注意:此字段可能返回 null,表示取不到有效值。
	TaskId *string `json:"TaskId,omitnil,omitempty" name:"TaskId"`

	// 该字段用于返回调用视频审核接口时传入的数据ID参数,方便数据的辨别和管理。
	// 注意:此字段可能返回 null,表示取不到有效值。
	DataId *string `json:"DataId,omitnil,omitempty" name:"DataId"`

	// 该字段用于返回调用视频审核接口时传入的BizType参数,方便数据的辨别和管理。
	// 注意:此字段可能返回 null,表示取不到有效值。
	BizType *string `json:"BizType,omitnil,omitempty" name:"BizType"`

	// 该字段用于返回调用视频审核接口时传入的TaskInput参数中的任务名称,方便任务的识别与管理。
	// 注意:此字段可能返回 null,表示取不到有效值。
	Name *string `json:"Name,omitnil,omitempty" name:"Name"`

	// 该字段用于返回所查询内容的任务状态。
	// <br>取值:**FINISH**(任务已完成)、**PENDING** (任务等待中)、**RUNNING** (任务进行中)、**ERROR** (任务出错)、**CANCELLED** (任务已取消)。
	// 注意:此字段可能返回 null,表示取不到有效值。
	Status *string `json:"Status,omitnil,omitempty" name:"Status"`

	// 该字段用于返回调用视频审核接口时输入的视频审核类型,取值为:**VIDEO**(点播视频)和**LIVE_VIDEO**(直播视频),默认值为VIDEO。
	// 注意:此字段可能返回 null,表示取不到有效值。
	Type *string `json:"Type,omitnil,omitempty" name:"Type"`

	// 该字段用于返回基于恶意标签的后续操作建议。当您获取到判定结果后,返回值表示系统推荐的后续操作;建议您按照业务所需,对不同违规类型与建议值进行处理。<br>返回值:**Block**:建议屏蔽,**Review** :建议人工复审,**Pass**:建议通过
	// 注意:此字段可能返回 null,表示取不到有效值。
	Suggestion *string `json:"Suggestion,omitnil,omitempty" name:"Suggestion"`

	// 该字段用于返回检测结果所对应的恶意标签。<br>返回值:**Porn**:色情,**Abuse**:谩骂,**Ad**:广告,**Custom**:自定义违规;以及其他令人反感、不安全或不适宜的内容类型。
	// 注意:此字段可能返回 null,表示取不到有效值。
	Labels []*TaskLabel `json:"Labels,omitnil,omitempty" name:"Labels"`

	// 该字段用于返回输入媒体文件的详细信息,包括编解码格式、分片时长等信息。详细内容敬请参考MediaInfo数据结构的描述。
	// 注意:此字段可能返回 null,表示取不到有效值。
	MediaInfo *MediaInfo `json:"MediaInfo,omitnil,omitempty" name:"MediaInfo"`

	// 该字段用于返回审核服务的媒体内容信息,主要包括传入文件类型和访问地址。
	// 注意:此字段可能返回 null,表示取不到有效值。
	InputInfo *InputInfo `json:"InputInfo,omitnil,omitempty" name:"InputInfo"`

	// 该字段用于返回被查询任务创建的时间,格式采用 ISO 8601标准。
	// 注意:此字段可能返回 null,表示取不到有效值。
	CreatedAt *string `json:"CreatedAt,omitnil,omitempty" name:"CreatedAt"`

	// 该字段用于返回被查询任务最后更新时间,格式采用 ISO 8601标准。
	// 注意:此字段可能返回 null,表示取不到有效值。
	UpdatedAt *string `json:"UpdatedAt,omitnil,omitempty" name:"UpdatedAt"`

	// 在秒后重试
	// 注意:此字段可能返回 null,表示取不到有效值。
	TryInSeconds *int64 `json:"TryInSeconds,omitnil,omitempty" name:"TryInSeconds"`

	// 该字段用于返回视频中截帧审核的结果,详细返回内容敬请参考ImageSegments数据结构的描述。<br>备注:数据有效期为24小时,如需要延长存储时间,请在已配置的COS储存桶中设置。
	// 注意:此字段可能返回 null,表示取不到有效值。
	ImageSegments []*ImageSegments `json:"ImageSegments,omitnil,omitempty" name:"ImageSegments"`

	// 该字段用于返回视频中音频审核的结果,详细返回内容敬请参考AudioSegments数据结构的描述。<br>备注:数据有效期为24小时,如需要延长存储时间,请在已配置的COS储存桶中设置。
	// 注意:此字段可能返回 null,表示取不到有效值。
	AudioSegments []*AudioSegments `json:"AudioSegments,omitnil,omitempty" name:"AudioSegments"`

	// 当任务状态为Error时,返回对应错误的类型,取值:
	// **DECODE_ERROR**: 解码失败。(输入资源中可能包含无法解码的视频)
	// **URL_ERROR**:下载地址验证失败。
	// **TIMEOUT_ERROR**:处理超时。
	// **CALLBACK_ERRORR**:回调错误。
	// **MODERATION_ERROR**:审核失败。
	// **URL_NOT_SUPPORTED**:源文件太大或没有图片音频帧
	// 任务状态非Error时默认返回为空。
	// 注意:此字段可能返回 null,表示取不到有效值。
	ErrorType *string `json:"ErrorType,omitnil,omitempty" name:"ErrorType"`

	// 当任务状态为Error时,该字段用于返回对应错误的详细描述,任务状态非Error时默认返回为空。
	// 注意:此字段可能返回 null,表示取不到有效值。
	ErrorDescription *string `json:"ErrorDescription,omitnil,omitempty" name:"ErrorDescription"`

	// 该字段用于返回检测结果所对应的标签。如果未命中恶意,返回Normal,如果命中恶意,则返回Labels中优先级最高的标签
	// 注意:此字段可能返回 null,表示取不到有效值。
	Label *string `json:"Label,omitnil,omitempty" name:"Label"`

	// 该字段用于返回音频文件识别出的对应文本内容,最大支持**前1000个字符**。
	// 注意:此字段可能返回 null,表示取不到有效值。
	AudioText *string `json:"AudioText,omitnil,omitempty" name:"AudioText"`

	// 该字段用于返回音频文件识别出的对应文本内容。
	// 注意:此字段可能返回 null,表示取不到有效值。
	Asrs []*RcbAsr `json:"Asrs,omitnil,omitempty" name:"Asrs"`

	// 该字段用于返回检测结果明细数据相关的cos url
	// 注意:此字段可能返回 null,表示取不到有效值。
	SegmentCosUrlList *SegmentCosUrlList `json:"SegmentCosUrlList,omitnil,omitempty" name:"SegmentCosUrlList"`

	// 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
	RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"`
}

Predefined struct for user

type DescribeTasksRequest

type DescribeTasksRequest struct {
	*tchttp.BaseRequest

	// 该参数表示任务列表每页展示的任务条数,**默认值为10**(每页展示10条任务)。
	Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"`

	// 该参数表示任务筛选器的输入参数,可根据业务类型、审核文件类型、处理建议及任务状态筛选想要查看的审核任务,具体参数内容请参见TaskFilter数据结构的详细描述。
	Filter *TaskFilter `json:"Filter,omitnil,omitempty" name:"Filter"`

	// 该参数表示翻页时使用的Token信息,由系统自动生成,并在翻页时向下一个生成的页面传递此参数,以方便快速翻页功能的实现。当到最后一页时,该字段为空。
	PageToken *string `json:"PageToken,omitnil,omitempty" name:"PageToken"`

	// 该参数表示任务列表的开始时间,格式为ISO8601标准的时间戳。**默认值为最近3天**,若传入该参数,则在这一时间到EndTime之间的任务将会被筛选出来。<br>备注:该参数与Filter共同起到任务筛选作用,二者作用无先后顺序。
	StartTime *string `json:"StartTime,omitnil,omitempty" name:"StartTime"`

	// 该参数表示任务列表的结束时间,格式为ISO8601标准的时间戳。**默认值为空**,若传入该参数,则在这StartTime到这一时间之间的任务将会被筛选出来。<br>备注:该参数与Filter共同起到任务筛选作用,二者作用无先后顺序。
	EndTime *string `json:"EndTime,omitnil,omitempty" name:"EndTime"`
}

func NewDescribeTasksRequest

func NewDescribeTasksRequest() (request *DescribeTasksRequest)

func (*DescribeTasksRequest) FromJsonString

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

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

func (*DescribeTasksRequest) ToJsonString

func (r *DescribeTasksRequest) ToJsonString() string

type DescribeTasksRequestParams

type DescribeTasksRequestParams struct {
	// 该参数表示任务列表每页展示的任务条数,**默认值为10**(每页展示10条任务)。
	Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"`

	// 该参数表示任务筛选器的输入参数,可根据业务类型、审核文件类型、处理建议及任务状态筛选想要查看的审核任务,具体参数内容请参见TaskFilter数据结构的详细描述。
	Filter *TaskFilter `json:"Filter,omitnil,omitempty" name:"Filter"`

	// 该参数表示翻页时使用的Token信息,由系统自动生成,并在翻页时向下一个生成的页面传递此参数,以方便快速翻页功能的实现。当到最后一页时,该字段为空。
	PageToken *string `json:"PageToken,omitnil,omitempty" name:"PageToken"`

	// 该参数表示任务列表的开始时间,格式为ISO8601标准的时间戳。**默认值为最近3天**,若传入该参数,则在这一时间到EndTime之间的任务将会被筛选出来。<br>备注:该参数与Filter共同起到任务筛选作用,二者作用无先后顺序。
	StartTime *string `json:"StartTime,omitnil,omitempty" name:"StartTime"`

	// 该参数表示任务列表的结束时间,格式为ISO8601标准的时间戳。**默认值为空**,若传入该参数,则在这StartTime到这一时间之间的任务将会被筛选出来。<br>备注:该参数与Filter共同起到任务筛选作用,二者作用无先后顺序。
	EndTime *string `json:"EndTime,omitnil,omitempty" name:"EndTime"`
}

Predefined struct for user

type DescribeTasksResponse

type DescribeTasksResponse struct {
	*tchttp.BaseResponse
	Response *DescribeTasksResponseParams `json:"Response"`
}

func NewDescribeTasksResponse

func NewDescribeTasksResponse() (response *DescribeTasksResponse)

func (*DescribeTasksResponse) FromJsonString

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

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

func (*DescribeTasksResponse) ToJsonString

func (r *DescribeTasksResponse) ToJsonString() string

type DescribeTasksResponseParams

type DescribeTasksResponseParams struct {
	// 该字段用于返回当前查询的任务总量,格式为int字符串。
	// 注意:此字段可能返回 null,表示取不到有效值。
	Total *string `json:"Total,omitnil,omitempty" name:"Total"`

	// 该字段用于返回当前页的任务详细数据,具体输出内容请参见TaskData数据结构的详细描述。
	// 注意:此字段可能返回 null,表示取不到有效值。
	Data []*TaskData `json:"Data,omitnil,omitempty" name:"Data"`

	// 该字段用于返回翻页时使用的Token信息,由系统自动生成,并在翻页时向下一个生成的页面传递此参数,以方便快速翻页功能的实现。当到最后一页时,该字段为空。
	// 注意:此字段可能返回 null,表示取不到有效值。
	PageToken *string `json:"PageToken,omitnil,omitempty" name:"PageToken"`

	// 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
	RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"`
}

Predefined struct for user

type ImageResult

type ImageResult struct {
	// 违规标志
	// 0 未命中
	// 1 命中
	// 注意:此字段可能返回 null,表示取不到有效值。
	HitFlag *int64 `json:"HitFlag,omitnil,omitempty" name:"HitFlag"`

	// 命中的标签
	// Porn 色情
	// Sexy 性感
	// Polity 政治
	// Illegal 违法
	// Abuse 谩骂
	// Terror 暴恐
	// Ad 广告
	// 注意:此字段可能返回 null,表示取不到有效值。
	Label *string `json:"Label,omitnil,omitempty" name:"Label"`

	// 审核建议,可选值:
	// Pass 通过,
	// Review 建议人审,
	// Block 确认违规
	// 注意:此字段可能返回 null,表示取不到有效值。
	Suggestion *string `json:"Suggestion,omitnil,omitempty" name:"Suggestion"`

	// 得分
	// 注意:此字段可能返回 null,表示取不到有效值。
	Score *int64 `json:"Score,omitnil,omitempty" name:"Score"`

	// 画面截帧图片结果集
	// 注意:此字段可能返回 null,表示取不到有效值。
	Results []*ImageResultResult `json:"Results,omitnil,omitempty" name:"Results"`

	// 图片URL地址
	// 注意:此字段可能返回 null,表示取不到有效值。
	Url *string `json:"Url,omitnil,omitempty" name:"Url"`

	// 附加字段
	// 注意:此字段可能返回 null,表示取不到有效值。
	Extra *string `json:"Extra,omitnil,omitempty" name:"Extra"`
}

type ImageResultResult

type ImageResultResult struct {
	// 场景
	// Porn 色情
	// Sexy 性感
	// Polity 政治
	// Illegal 违法
	// Abuse 谩骂
	// Terror 暴恐
	// Ad 广告
	// 注意:此字段可能返回 null,表示取不到有效值。
	Scene *string `json:"Scene,omitnil,omitempty" name:"Scene"`

	// 是否命中
	// 0 未命中
	// 1 命中
	// 注意:此字段可能返回 null,表示取不到有效值。
	HitFlag *int64 `json:"HitFlag,omitnil,omitempty" name:"HitFlag"`

	// 审核建议,可选值:
	// Pass 通过,
	// Review 建议人审,
	// Block 确认违规
	// 注意:此字段可能返回 null,表示取不到有效值。
	Suggestion *string `json:"Suggestion,omitnil,omitempty" name:"Suggestion"`

	// 标签
	// 注意:此字段可能返回 null,表示取不到有效值。
	Label *string `json:"Label,omitnil,omitempty" name:"Label"`

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

	// 分数
	// 注意:此字段可能返回 null,表示取不到有效值。
	Score *int64 `json:"Score,omitnil,omitempty" name:"Score"`

	// 人物名称列表,如未识别,则为null
	// 注意:此字段可能返回 null,表示取不到有效值。
	Names []*string `json:"Names,omitnil,omitempty" name:"Names"`

	// 图片OCR文本
	// 注意:此字段可能返回 null,表示取不到有效值。
	Text *string `json:"Text,omitnil,omitempty" name:"Text"`

	// 其他详情
	// 注意:此字段可能返回 null,表示取不到有效值。
	Details []*ImageResultsResultDetail `json:"Details,omitnil,omitempty" name:"Details"`
}

type ImageResultsResultDetail

type ImageResultsResultDetail struct {
	// 任务名称
	// 注意:此字段可能返回 null,表示取不到有效值。
	Name *string `json:"Name,omitnil,omitempty" name:"Name"`

	// OCR识别文本
	// 注意:此字段可能返回 null,表示取不到有效值。
	Text *string `json:"Text,omitnil,omitempty" name:"Text"`

	// 位置信息
	// 注意:此字段可能返回 null,表示取不到有效值。
	Location *ImageResultsResultDetailLocation `json:"Location,omitnil,omitempty" name:"Location"`

	// 标签
	// 注意:此字段可能返回 null,表示取不到有效值。
	Label *string `json:"Label,omitnil,omitempty" name:"Label"`

	// 库ID
	// 注意:此字段可能返回 null,表示取不到有效值。
	LibId *string `json:"LibId,omitnil,omitempty" name:"LibId"`

	// 库名称
	// 注意:此字段可能返回 null,表示取不到有效值。
	LibName *string `json:"LibName,omitnil,omitempty" name:"LibName"`

	// 命中的关键词
	// 注意:此字段可能返回 null,表示取不到有效值。
	Keywords []*string `json:"Keywords,omitnil,omitempty" name:"Keywords"`

	// 建议
	// 注意:此字段可能返回 null,表示取不到有效值。
	Suggestion *string `json:"Suggestion,omitnil,omitempty" name:"Suggestion"`

	// 得分
	// 注意:此字段可能返回 null,表示取不到有效值。
	Score *int64 `json:"Score,omitnil,omitempty" name:"Score"`

	// 子标签码
	// 注意:此字段可能返回 null,表示取不到有效值。
	SubLabelCode *string `json:"SubLabelCode,omitnil,omitempty" name:"SubLabelCode"`
}

type ImageResultsResultDetailLocation

type ImageResultsResultDetailLocation struct {
	// x坐标
	// 注意:此字段可能返回 null,表示取不到有效值。
	X *float64 `json:"X,omitnil,omitempty" name:"X"`

	// y坐标
	// 注意:此字段可能返回 null,表示取不到有效值。
	Y *float64 `json:"Y,omitnil,omitempty" name:"Y"`

	// 宽度
	// 注意:此字段可能返回 null,表示取不到有效值。
	Width *int64 `json:"Width,omitnil,omitempty" name:"Width"`

	// 高度
	// 注意:此字段可能返回 null,表示取不到有效值。
	Height *int64 `json:"Height,omitnil,omitempty" name:"Height"`

	// 旋转角度
	// 注意:此字段可能返回 null,表示取不到有效值。
	Rotate *float64 `json:"Rotate,omitnil,omitempty" name:"Rotate"`
}

type ImageSegments

type ImageSegments struct {
	// 截帧时间。
	// 点播文件:该值为相对于视频偏移时间,单位为秒,例如:0,5,10
	// 直播流:该值为时间戳,例如:1594650717
	OffsetTime *string `json:"OffsetTime,omitnil,omitempty" name:"OffsetTime"`

	// 画面截帧结果详情
	Result *ImageResult `json:"Result,omitnil,omitempty" name:"Result"`
}

type InputInfo

type InputInfo struct {
	// 传入的类型可选:URL,COS
	// 注意:此字段可能返回 null,表示取不到有效值。
	Type *string `json:"Type,omitnil,omitempty" name:"Type"`

	// Url地址
	// 注意:此字段可能返回 null,表示取不到有效值。
	Url *string `json:"Url,omitnil,omitempty" name:"Url"`

	// 桶信息。当输入当时COS时,该字段不为空
	// 注意:此字段可能返回 null,表示取不到有效值。
	BucketInfo *string `json:"BucketInfo,omitnil,omitempty" name:"BucketInfo"`
}

type MediaInfo

type MediaInfo struct {
	// 编码格式
	Codecs *string `json:"Codecs,omitnil,omitempty" name:"Codecs"`

	// 流检测时分片时长
	// 注意:此字段可能返回 0,表示取不到有效值。
	Duration *int64 `json:"Duration,omitnil,omitempty" name:"Duration"`

	// 宽,单位为像素
	Width *int64 `json:"Width,omitnil,omitempty" name:"Width"`

	// 高,单位为像素
	Height *int64 `json:"Height,omitnil,omitempty" name:"Height"`

	// 封面
	Thumbnail *string `json:"Thumbnail,omitnil,omitempty" name:"Thumbnail"`
}

type RcbAsr added in v1.0.496

type RcbAsr struct {
	// 该字段用于返回音频文件识别出的对应文本内容,最大支持**前1000个字符**。
	// 注意:此字段可能返回 null,表示取不到有效值。
	Text *string `json:"Text,omitnil,omitempty" name:"Text"`

	// 该字段用于返回被查询任务创建的时间,格式采用 ISO 8601标准。
	// 注意:此字段可能返回 null,表示取不到有效值。
	CreatedAt *string `json:"CreatedAt,omitnil,omitempty" name:"CreatedAt"`
}

type RecognitionResult added in v1.0.493

type RecognitionResult struct {
	// 可能的取值有:Teenager 、Gender
	// 注意:此字段可能返回 null,表示取不到有效值。
	Label *string `json:"Label,omitnil,omitempty" name:"Label"`

	// 识别标签列表
	// 注意:此字段可能返回 null,表示取不到有效值。
	Tags []*Tag `json:"Tags,omitnil,omitempty" name:"Tags"`
}

type SegmentCosUrlList added in v1.0.788

type SegmentCosUrlList struct {
	// 全量图片片段的cos url
	// 注意:此字段可能返回 null,表示取不到有效值。
	ImageAllUrl *string `json:"ImageAllUrl,omitnil,omitempty" name:"ImageAllUrl"`

	// 全量音频片段的cos url
	// 注意:此字段可能返回 null,表示取不到有效值。
	AudioAllUrl *string `json:"AudioAllUrl,omitnil,omitempty" name:"AudioAllUrl"`

	// 违规图片片段的cos url
	// 注意:此字段可能返回 null,表示取不到有效值。
	ImageBlockUrl *string `json:"ImageBlockUrl,omitnil,omitempty" name:"ImageBlockUrl"`

	// 违规音频片段的cos url
	// 注意:此字段可能返回 null,表示取不到有效值。
	AudioBlockUrl *string `json:"AudioBlockUrl,omitnil,omitempty" name:"AudioBlockUrl"`

	// 全量音频识别文本的cos url
	// 注意:此字段可能返回 null,表示取不到有效值。
	AsrUrl *string `json:"AsrUrl,omitnil,omitempty" name:"AsrUrl"`
}

type StorageInfo

type StorageInfo struct {
	// 类型 可选:
	// URL 资源链接类型
	// COS 腾讯云对象存储类型
	Type *string `json:"Type,omitnil,omitempty" name:"Type"`

	// 资源链接
	Url *string `json:"Url,omitnil,omitempty" name:"Url"`

	// 腾讯云存储桶信息
	BucketInfo *BucketInfo `json:"BucketInfo,omitnil,omitempty" name:"BucketInfo"`
}

type Tag added in v1.0.493

type Tag struct {
	// 根据Label字段确定具体名称:
	// 当Label 为Teenager 时 Name可能取值有:Teenager
	// 当Label 为Gender 时 Name可能取值有:Male 、Female
	// 注意:此字段可能返回 null,表示取不到有效值。
	Name *string `json:"Name,omitnil,omitempty" name:"Name"`

	// 置信分:0~100,数值越大表示置信度越高
	// 注意:此字段可能返回 null,表示取不到有效值。
	Score *int64 `json:"Score,omitnil,omitempty" name:"Score"`

	// 识别开始偏移时间,单位:毫秒
	// 注意:此字段可能返回 null,表示取不到有效值。
	StartTime *float64 `json:"StartTime,omitnil,omitempty" name:"StartTime"`

	// 识别结束偏移时间,单位:毫秒
	// 注意:此字段可能返回 null,表示取不到有效值。
	EndTime *float64 `json:"EndTime,omitnil,omitempty" name:"EndTime"`
}

type TaskData

type TaskData struct {
	// 任务ID
	// 注意:此字段可能返回 null,表示取不到有效值。
	TaskId *string `json:"TaskId,omitnil,omitempty" name:"TaskId"`

	// 输入的数据ID
	// 注意:此字段可能返回 null,表示取不到有效值。
	DataId *string `json:"DataId,omitnil,omitempty" name:"DataId"`

	// 业务类型
	// 注意:此字段可能返回 null,表示取不到有效值。
	BizType *string `json:"BizType,omitnil,omitempty" name:"BizType"`

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

	// 状态,可选:PENDING,RUNNING,ERROR,FINISH,CANCELLED
	// 注意:此字段可能返回 null,表示取不到有效值。
	Status *string `json:"Status,omitnil,omitempty" name:"Status"`

	// 任务类型
	// 注意:此字段可能返回 null,表示取不到有效值。
	Type *string `json:"Type,omitnil,omitempty" name:"Type"`

	// 处理建议
	// 注意:此字段可能返回 null,表示取不到有效值。
	Suggestion *string `json:"Suggestion,omitnil,omitempty" name:"Suggestion"`

	// 标签
	// 注意:此字段可能返回 null,表示取不到有效值。
	Labels []*TaskLabel `json:"Labels,omitnil,omitempty" name:"Labels"`

	// 媒体信息
	// 注意:此字段可能返回 null,表示取不到有效值。
	MediaInfo *MediaInfo `json:"MediaInfo,omitnil,omitempty" name:"MediaInfo"`

	// 输入信息
	// 注意:此字段可能返回 null,表示取不到有效值。
	InputInfo *InputInfo `json:"InputInfo,omitnil,omitempty" name:"InputInfo"`

	// 创建时间
	// 注意:此字段可能返回 null,表示取不到有效值。
	CreatedAt *string `json:"CreatedAt,omitnil,omitempty" name:"CreatedAt"`

	// 更新时间
	// 注意:此字段可能返回 null,表示取不到有效值。
	UpdatedAt *string `json:"UpdatedAt,omitnil,omitempty" name:"UpdatedAt"`
}

type TaskFilter

type TaskFilter struct {
	// 任务业务类型
	BizType *string `json:"BizType,omitnil,omitempty" name:"BizType"`

	// 任务类型,可选:VIDEO,AUDIO, LIVE_VIDEO, LIVE_AUDIO
	Type *string `json:"Type,omitnil,omitempty" name:"Type"`

	// 建议,可选:Pass, Review,Block
	Suggestion *string `json:"Suggestion,omitnil,omitempty" name:"Suggestion"`

	// 状态,可选:PENDING,RUNNING,ERROR,FINISH,CANCELLED
	TaskStatus *string `json:"TaskStatus,omitnil,omitempty" name:"TaskStatus"`
}

type TaskInput

type TaskInput struct {
	// 数据ID
	DataId *string `json:"DataId,omitnil,omitempty" name:"DataId"`

	// 任务名
	Name *string `json:"Name,omitnil,omitempty" name:"Name"`

	// 任务输入
	Input *StorageInfo `json:"Input,omitnil,omitempty" name:"Input"`
}

type TaskLabel

type TaskLabel struct {
	// 命中的标签
	// Porn 色情
	// Sexy 性感
	// Polity 政治
	// Illegal 违法
	// Abuse 谩骂
	// Terror 暴恐
	// Ad 广告
	// 注意:此字段可能返回 null,表示取不到有效值。
	Label *string `json:"Label,omitnil,omitempty" name:"Label"`

	// 审核建议,可选值:
	// Pass 通过,
	// Review 建议人审,
	// Block 确认违规
	// 注意:此字段可能返回 null,表示取不到有效值。
	Suggestion *string `json:"Suggestion,omitnil,omitempty" name:"Suggestion"`

	// 得分,分数是 0 ~ 100
	// 注意:此字段可能返回 null,表示取不到有效值。
	Score *int64 `json:"Score,omitnil,omitempty" name:"Score"`

	// 命中的二级标签
	// 注意:此字段可能返回 null,表示取不到有效值。
	SubLabel *string `json:"SubLabel,omitnil,omitempty" name:"SubLabel"`
}

type TaskResult

type TaskResult struct {
	// 请求时传入的DataId
	// 注意:此字段可能返回 null,表示取不到有效值。
	DataId *string `json:"DataId,omitnil,omitempty" name:"DataId"`

	// TaskId,任务ID
	// 注意:此字段可能返回 null,表示取不到有效值。
	TaskId *string `json:"TaskId,omitnil,omitempty" name:"TaskId"`

	// 错误码。如果code为OK,则表示创建成功,其他则参考公共错误码
	// 注意:此字段可能返回 null,表示取不到有效值。
	Code *string `json:"Code,omitnil,omitempty" name:"Code"`

	// 如果错误,该字段表示错误详情
	// 注意:此字段可能返回 null,表示取不到有效值。
	Message *string `json:"Message,omitnil,omitempty" name:"Message"`
}

type User added in v1.0.824

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

	// 该字段表示业务用户ID对应的账号类型,取值:1-微信uin,2-QQ号,3-微信群uin,4-qq群号,5-微信openid,6-QQopenid,7-其它string。
	// 该字段与账号ID参数(UserId)配合使用可确定唯一账号。
	AccountType *string `json:"AccountType,omitnil,omitempty" name:"AccountType"`

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

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

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

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

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

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

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

	// 群聊场景房间ID
	RoomId *string `json:"RoomId,omitnil,omitempty" name:"RoomId"`

	// 群聊场景群ID
	GroupId *string `json:"GroupId,omitnil,omitempty" name:"GroupId"`

	// 群聊场景群用户数
	GroupSize *int64 `json:"GroupSize,omitnil,omitempty" name:"GroupSize"`

	// 消息接收者ID
	ReceiverId *string `json:"ReceiverId,omitnil,omitempty" name:"ReceiverId"`

	// 消息生成时间,毫秒
	SendTime *string `json:"SendTime,omitnil,omitempty" name:"SendTime"`
}

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL