帮你快速理解、总结文档立即下载
文档中心>对象存储>SDK 文档>iOS SDK>内容识别>视频人像抠图

视频人像抠图

最近更新时间：2026-10-10 18:24:26
本文档已由 AI 辅助审校
我的收藏

本页目录：

简介

本文档提供关于视频人像抠图的相关 API 概览以及 SDK 示例代码。
API
操作描述
提交一个视频人像抠图任务。

SDK API 参考

SDK 所有接口的具体参数与方法说明，请参考 SDK API。

提交任务

功能说明

提交一个视频人像抠图任务。
说明：
COS iOS SDK 版本需要大于等于 v6.2.9。

示例代码

Objective-C
    QCloudPostSegmentVideoBodyRequest * request = [QCloudPostSegmentVideoBodyRequest new];
    request.bucket = @"sample-1250000000";
    request.regionName = @"COS_REGIONNAME";
    request.input = [QCloudPostSegmentVideoBody new];
    // 创建任务的 Tag：SegmentVideoBody;是否必传：是
    request.input.Tag = @"SegmentVideoBody";
    // 待操作的对象信息;是否必传：是
    request.input.Input = [QCloudPostSegmentVideoBodyInput new];
    // 文件路径;是否必传：是
    request.input.Input.Object = @"";
    // 操作规则;是否必传：是
    request.input.Operation = [QCloudPostSegmentVideoBodyOperation new];
    // 视频人像抠图配置;是否必传：否
    request.input.Operation.SegmentVideoBody = [QCloudPostSegmentVideoBodySegmentVideoBody new];
    // 结果输出配置;是否必传：是
    request.input.Operation.Output = [QCloudPostSegmentVideoBodyOutput new];
    // 存储桶的地域;是否必传：是
    request.input.Operation.Output.Region = @"";
    // 存储结果的存储桶;是否必传：是
    request.input.Operation.Output.Bucket = @"";
    // 输出结果的文件名;是否必传：是
    request.input.Operation.Output.Object = @"";
    // 任务回调 TDMQ 配置，当 CallBackType 为 TDMQ 时必填。详情见 CallBackMqConfig;是否必传：否
    request.input.CallBackMqConfig = [QCloudCallBackMqConfig new];
    // 消息队列所属园区，目前支持园区 sh（上海）、bj（北京）、gz（广州）、cd（成都）、hk（中国香港）;是否必传：是
    request.input.CallBackMqConfig.MqRegion = @"";
    // 消息队列使用模式，默认 Queue ：主题订阅：Topic队列服务: Queue;是否必传：是
    request.input.CallBackMqConfig.MqMode = @"";
    // TDMQ 主题名称;是否必传：是
    request.input.CallBackMqConfig.MqName = @"";

    [request setFinishBlock:^(QCloudPostSegmentVideoBodyResponse * outputObject, NSError *error) {
        // result：QCloudPostSegmentVideoBodyResponse 包含所有的响应；
        // 具体查看代码注释或api文档：https://cloud.tencent.com/document/product/460/83973
        // outputObject返回JobId，使用QCloudGetMediaJobRequest 查询结果
    }];
    [[QCloudCOSXMLService defaultCOSXML] PostSegmentVideoBody:request];

注意：
更多完整示例，请前往 GitHub 查看。
Swift

let request = QCloudPostSegmentVideoBodyRequest()
request.bucket = "sample-1250000000"
request.regionName = "COS_REGIONNAME"
request.input = QCloudPostSegmentVideoBody()
// 创建任务的 Tag：SegmentVideoBody；是否必传：是
request.input.tag = "SegmentVideoBody"
// 待操作的对象信息；是否必传：是
request.input.input = QCloudPostSegmentVideoBodyInput()
// 文件路径；是否必传：是
request.input.input.object = ""
// 操作规则；是否必传：是
request.input.operation = QCloudPostSegmentVideoBodyOperation()
// 视频人像抠图配置；是否必传：否
request.input.operation.segmentVideoBody = QCloudPostSegmentVideoBodySegmentVideoBody()
// 结果输出配置；是否必传：是
request.input.operation.output = QCloudPostSegmentVideoBodyOutput()
// 存储桶的地域；是否必传：是
request.input.operation.output.region = ""
// 存储结果的存储桶；是否必传：是
request.input.operation.output.bucket = ""
// 输出结果的文件名；是否必传：是
request.input.operation.output.object = ""
// 任务回调 TDMQ 配置，当 CallBackType 为 TDMQ 时必填；是否必传：否
request.input.callBackMqConfig = QCloudCallBackMqConfig()
// 消息队列所属园区，目前支持园区 sh（上海）、bj（北京）、gz（广州）、cd（成都）、hk（中国香港）；是否必传：是
request.input.callBackMqConfig.mqRegion = ""
// 消息队列使用模式，默认 Queue；主题订阅：Topic，队列服务：Queue；是否必传：是
request.input.callBackMqConfig.mqMode = ""
// TDMQ 主题名称；是否必传：是
request.input.callBackMqConfig.mqName = ""
request.setFinishBlock { outputObject, error in
    // outputObject：QCloudPostSegmentVideoBodyResponse 包含所有的响应
    // 具体查看代码注释或 API 文档：https://cloud.tencent.com/document/product/460/83973
    // outputObject 返回 JobId，使用 QCloudGetMediaJobRequest 查询结果
}
QCloudCOSXMLService.defaultCOSXML().postSegmentVideoBody(request)


注意：
更多完整示例，请前往 GitHub 查看。

中国站