Documentation ¶
Index ¶
- Constants
- type AudioResult
- type AudioResultDetailLanguageResult
- type AudioResultDetailMoanResult
- type AudioResultDetailTextResult
- type AudioSegments
- type BucketInfo
- type CancelTaskRequest
- type CancelTaskRequestParams
- type CancelTaskResponse
- type CancelTaskResponseParams
- type Client
- func (c *Client) CancelTask(request *CancelTaskRequest) (response *CancelTaskResponse, err error)
- func (c *Client) CancelTaskWithContext(ctx context.Context, request *CancelTaskRequest) (response *CancelTaskResponse, err error)
- func (c *Client) CreateVideoModerationTask(request *CreateVideoModerationTaskRequest) (response *CreateVideoModerationTaskResponse, err error)
- func (c *Client) CreateVideoModerationTaskWithContext(ctx context.Context, request *CreateVideoModerationTaskRequest) (response *CreateVideoModerationTaskResponse, err error)
- func (c *Client) DescribeTaskDetail(request *DescribeTaskDetailRequest) (response *DescribeTaskDetailResponse, err error)
- func (c *Client) DescribeTaskDetailWithContext(ctx context.Context, request *DescribeTaskDetailRequest) (response *DescribeTaskDetailResponse, err error)
- func (c *Client) DescribeTasks(request *DescribeTasksRequest) (response *DescribeTasksResponse, err error)
- func (c *Client) DescribeTasksWithContext(ctx context.Context, request *DescribeTasksRequest) (response *DescribeTasksResponse, err error)
- type CreateVideoModerationTaskRequest
- type CreateVideoModerationTaskRequestParams
- type CreateVideoModerationTaskResponse
- type CreateVideoModerationTaskResponseParams
- type DescribeTaskDetailRequest
- type DescribeTaskDetailRequestParams
- type DescribeTaskDetailResponse
- type DescribeTaskDetailResponseParams
- type DescribeTasksRequest
- type DescribeTasksRequestParams
- type DescribeTasksResponse
- type DescribeTasksResponseParams
- type ImageResult
- type ImageResultResult
- type ImageResultsResultDetail
- type ImageResultsResultDetailLocation
- type ImageSegments
- type InputInfo
- type MediaInfo
- type RcbAsr
- type RecognitionResult
- type SegmentCosUrlList
- type StorageInfo
- type Tag
- type TaskData
- type TaskFilter
- type TaskInput
- type TaskLabel
- type TaskResult
- type User
Constants ¶
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" )
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 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 ¶
func NewClient ¶
func NewClient(credential common.CredentialIface, region string, clientProfile *profile.ClientProfile) (client *Client, err error)
func NewClientWithSecretId ¶
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 RecognitionResult ¶ added in v1.0.493
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"` }