Package com.tencentcloudapi.ivld.v20210903

Class IvldClient

    • Method Detail

      • CreateCustomCategory

        public CreateCustomCategoryResponse CreateCustomCategory​(CreateCustomCategoryRequest req)
                                                  throws TencentCloudSDKException
        创建自定义人物分类信息 当L2Category为空时，将创建一级自定义分类。 当L1Category与L2Category均不为空时，将创建二级自定义分类。请注意，**只有当一级自定义分类存在时，才可创建二级自定义分类**。
        Parameters:
        req - CreateCustomCategoryRequest
        Returns:
        CreateCustomCategoryResponse
        Throws:
        TencentCloudSDKException

      • CreateCustomGroup

        public CreateCustomGroupResponse CreateCustomGroup​(CreateCustomGroupRequest req)
                                            throws TencentCloudSDKException
        创建自定义人物库 Bucket的格式参考为 `bucketName-123456.cos.ap-shanghai.myqcloud.com` 在调用CreateCustomPerson和AddCustomPersonImage接口之前，请先确保本接口成功调用。当前每个用户只支持一个自定义人物库，一旦自定义人物库创建成功，后续接口调用均会返回人物库已存在错误。 由于人脸图片对于自定义人物识别至关重要，因此自定义人物识别功能需要用户显式指定COS存储桶方可使用。具体来说，自定义人物识别功能接口(主要是CreateCustomPerson和AddCustomPersonImage)会在此COS桶下面新建IVLDCustomPersonImage目录，并在此目录下存储自定义人物图片数据以支持后续潜在的特征更新。 请注意：本接口指定的COS桶仅用于**备份存储自定义人物图片**，CreateCustomPerson和AddCustomPersonImage接口入参URL可使用任意COS存储桶下的任意图片。 重要**：请务必确保本接口指定的COS存储桶存在(不要手动删除COS桶)。COS存储桶一旦指定，将不能修改。
        Parameters:
        req - CreateCustomGroupRequest
        Returns:
        CreateCustomGroupResponse
        Throws:
        TencentCloudSDKException

      • CreateCustomPerson

        public CreateCustomPersonResponse CreateCustomPerson​(CreateCustomPersonRequest req)
                                              throws TencentCloudSDKException
        创建自定义人物。 输入人物名称，基本信息，分类信息与人脸图片，创建自定义人物 人脸图片可使用图片数据(base64编码的图片数据)或者图片URL(推荐使用COS以减少下载时间，其他地址也支持)，原始图片优先，也即如果同时指定了图片数据和图片URL，接口将仅使用图片数据
        Parameters:
        req - CreateCustomPersonRequest
        Returns:
        CreateCustomPersonResponse
        Throws:
        TencentCloudSDKException

      • DeleteMedia

        public DeleteMediaResponse DeleteMedia​(DeleteMediaRequest req)
                                throws TencentCloudSDKException
        将MediaId对应的媒资文件从系统中删除。 请注意，本接口仅删除媒资文件，媒资文件对应的视频分析结果不会被删除**。如您需要删除结构化分析结果，请调用DeleteTask接口。
        Parameters:
        req - DeleteMediaRequest
        Returns:
        DeleteMediaResponse
        Throws:
        TencentCloudSDKException

      • DescribeMedia

        public DescribeMediaResponse DescribeMedia​(DescribeMediaRequest req)
                                    throws TencentCloudSDKException
        描述媒资文件信息，包括媒资状态，分辨率，帧率等。 如果媒资文件未完成导入，本接口将仅输出媒资文件的状态信息；导入完成后，本接口还将输出媒资文件的其他元信息。
        Parameters:
        req - DescribeMediaRequest
        Returns:
        DescribeMediaResponse
        Throws:
        TencentCloudSDKException

      • DescribeMedias

        public DescribeMediasResponse DescribeMedias​(DescribeMediasRequest req)
                                      throws TencentCloudSDKException
        依照输入条件，描述命中的媒资文件信息，包括媒资状态，分辨率，帧率等。 请注意，本接口最多支持同时描述**50**个媒资文件 如果媒资文件未完成导入，本接口将仅输出媒资文件的状态信息；导入完成后，本接口还将输出媒资文件的其他元信息。
        Parameters:
        req - DescribeMediasRequest
        Returns:
        DescribeMediasResponse
        Throws:
        TencentCloudSDKException

      • ImportMedia

        public ImportMediaResponse ImportMedia​(ImportMediaRequest req)
                                throws TencentCloudSDKException
        将URL指向的媒资视频文件导入系统之中。 请注意，本接口为异步接口**。接口返回MediaId仅代表导入视频任务发起，不代表任务完成，您可调用读接口(DescribeMedia/DescribeMedias)接口查询MediaId URL字段推荐您使用COS地址，其形式为`https://${Bucket}-${AppId}.cos.${Region}.myqcloud.com/${ObjectKey}`，其中`${Bucket}`为您的COS桶名称，Region为COS桶所在[可用区](https://cloud.tencent.com/document/product/213/6091)，`${ObjectKey}`为指向存储在COS桶内的待分析的视频的[ObjectKey](https://cloud.tencent.com/document/product/436/13324) 另外，目前产品也支持使用外部URL地址，但是当传入URL为非COS地址时，需要您指定额外的WriteBackCosPath以供产品回写结果数据。 分析完成后，本产品将在您的`${Bucket}`桶内创建名为`${ObjectKey}_${task-create-time}`的目录(`task-create-time`形式为1970-01-01T08:08:08)并将分析结果将回传回该目录，也即，结构化分析结果(包括图片，JSON等数据)将会写回`https://${Bucket}-${AppId}.cos.${Region}.myqcloud.com/${ObjectKey}_${task-create-time}`目录
        Parameters:
        req - ImportMediaRequest
        Returns:
        ImportMediaResponse
        Throws:
        TencentCloudSDKException

      • ModifyCallback

        public ModifyCallbackResponse ModifyCallback​(ModifyCallbackRequest req)
                                      throws TencentCloudSDKException
        用户设置对应事件的回调地址 ### 回调事件消息通知协议 #### 网络协议 - 回调接口协议目前仅支持http/https协议； - 请求：HTTP POST 请求，包体内容为 JSON，每一种消息的具体包体内容参见后文。 - 应答：HTTP STATUS CODE = 200，服务端忽略应答包具体内容，为了协议友好，建议客户应答内容携带 JSON： `{"code":0}` #### 通知可靠性 事件通知服务具备重试能力，事件通知失败后会总计重试3次； 为了避免重试对您的服务器以及网络带宽造成冲击，请保持正常回包。触发重试条件如下： - 长时间（5 秒）未回包应答。 - 应答 HTTP STATUS 不为200。 #### 回调接口协议 ##### 分析任务完成消息回调 | 参数名称 | 必选 | 类型 | 描述 | |---------|---------|---------|---------| | EventType | 是 | int | 回调时间类型，1-任务分析完成，2-媒资导入完成 | | TaskId | 是 | String | 任务ID | | TaskStatus | 是 | [TaskStatus](/document/product/1509/65063#TaskInfo) | 任务执行状态 | | FailedReason | 是 | String | 若任务失败，该字段为失败原因 | ##### 导入媒资完成消息回调 | 参数名称 | 必选 | 类型 | 描述 | |---------|---------|---------|---------| | EventType | 是 | int | 回调时间类型，1-任务分析完成，2-媒资导入完成 | | MediaId | 是 | String | 媒资ID | | MediaStatus | 是 | [MediaStatus](/document/product/1509/65063#MediaInfo) | 媒资导入状态| | FailedReason | 是 | String | 若任务失败，该字段为失败原因 |
        Parameters:
        req - ModifyCallbackRequest
        Returns:
        ModifyCallbackResponse
        Throws:
        TencentCloudSDKException

      • UpdateCustomCategory

        public UpdateCustomCategoryResponse UpdateCustomCategory​(UpdateCustomCategoryRequest req)
                                                  throws TencentCloudSDKException
        更新自定义人物分类 当L2Category为空时，代表更新CategoryId对应的一级自定义人物类型以及所有二级自定义人物类型所从属的一级自定义人物类型； 当L2Category非空时，仅更新CategoryId对应的二级自定义人物类型
        Parameters:
        req - UpdateCustomCategoryRequest
        Returns:
        UpdateCustomCategoryResponse
        Throws:
        TencentCloudSDKException