对象存储（Cloud Object Storage，COS）是腾讯云提供的一种存储海量文件的分布式存储服务，具有高扩展性、低成本、可靠安全等优点。通过控制台等方式，用户可简单、快速地接入 COS，进行多格式文件的上传、下载和管理，实现海量数据存储和管理。若您开通了人脸核身 COS 存储服务，我们会将您腾讯云账号下的人脸核身核验结果（包括身份证照片、人脸核身视频以及视频最佳帧）以及意愿核身结果（包括视频、屏幕截屏以及回答音频）自动转存到您腾讯云账号下的 COS 空间中，您可以到 COS 控制台 进行数据管理。
说明：
1. 该服务仅限全读写权限账号可开通，开通后主、子账号、协作者账号共用一个 COS 存储桶。
2. 若您在人脸核身控制台开通了数据存储服务，调用 GetDetectInfoEnhanced 或者 GetEidResult 接口拉取结果时，会将视频、图片、音频等相关字段的 base64替换为 COS 的路径。
3. 该 COS 的数据存储服务为收费服务，请您了解 COS 计费概述。
目前支持以下渠道接入的人脸核身以及意愿核身核验结果存储到 COS 空间。
接入渠道 | 人脸核身 | | | 意愿核身（问答+点头） | | |
| 身份证照片 | 人脸核身视频 | 视频最佳帧 | 意愿确认视频 | 屏幕截屏 | 回答音频（问答模式） |
微信小程序 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
H5（微信浏览器） | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
E证通 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
步骤一：授权流程
1. 登录人脸核身控制台，选择数据存储服务页面。在页面第一步服务授权单击前往授权跳转到授权页面。
2. 在服务授权页面单击同意授权。
3. 勾选阅读并同意《腾讯云服务协议》和《对象存储服务等级协议》后，单击确定创建。
4. 创建成功后会展示您的 COS 存储桶，腾讯云慧眼人脸核身将可以进入您的COS桶中写入资源，您可以到您的COS 控制台 中看到该存储桶并管理所存储的文件。
步骤二：开通流程
步骤一的授权流程只是授权腾讯云慧眼人脸核身能够访问您的COS部分资源，完成上述授权流程之后需要 联系我们 针对不同的产品进行开通。开通之后，对应产品的人脸核身核验结果（包括身份证照片、人脸核身视频以及视频最佳帧等）将自动转存到该 COS存储桶中，GetDetectInfoEnhanced 或者 GetEidResult 拉取核验结果时会将相关字段的 base64 替换为 COS 路径。
注意：
使用指引
开通数据存储服务后，调用 GetDetectInfoEnhanced 或者 GetEidResult 拉取核验结果时会将相关字段的 base64 替换为 COS 路径，不再返回base64格式的图片、视频等信息。 GetDetectInfoEnhanced 和 GetEidResult 接口中的 IsCustomizeStorage 字段标识当次请求是否已经开启COS存储，当该值返回 true 时，表示该次核身结果涉及到的图片、视频、音频（如有）文件已存储到您的COS存储桶中，对应的存储路径请见图片、视频、音频的输出参数（具体的字段名称详见QA部分），您可以通过该路径在存储桶bucket中找到对应的文件。存量服务可以参考如下代码片段完成服务改造之后再开通数据存储服务。
代码片段...// 调用拉取结果接口varresponse= client.GetDetectInfoEnhanced(request)// 处理响应结果ifresponse.IsCustomizeStorage {// TODO 处理COS路径} else {// TODO 处理base64}// 其他业务逻辑...
注意：
存量服务开通数据存储服务之前确保已经对 GetDetectInfoEnhanced 或者 GetEidResult 接口的响应做了相应的适配工作，防止开通之后不再返回base64数据导致线上服务异常。
数据存储服务常见问题
已经在控制台开通数据存储服务，但是 COS 桶中没有图片和视频？
数据存储服务的收费标准？
开通数据存储服务后，COS 路径怎么返回？
调用 GetDetectInfoEnhanced 或者 GetEidResult 接口拉取结果时，默认返回base64数据，开通数据存储服务后会将视频及图片字段的 base64替换为 COS 的路径返回。
图片和视频数据存储在哪里？
默认数据缓存在腾讯公有云，开通数据存储服务后存储在用户 COS 桶中。
开启自定义存储后哪些字段需要做特殊处理？
属性名 | 含义 | 备注 |
Response.IdCardData.OcrFront | OCR 正面照片 | - |
Response.IdCardData.OcrBack | OCR 反面照片 | - |
Response.IdCardData.ProcessedFrontImage | 旋转裁边后的正面照片 | - |
Response.IdCardData.ProcessedBackImage | 旋转裁边后的背面照片 | - |
Response.IdCardData.Avatar | 身份证正面人像图 | - |
Response.BestFrame.BestFrame | 活体比对最佳帧 | - |
Response.BestFrame.BestFrames[] | 自截帧 | 数组中所有项目都会返回 COS 路径 |
Response.VideoData.LivenessVideo | 活体视频 | - |
Response.IntentionQuestionResult.Video | 意愿核身问答模式全流程视频 | - |
Response.IntentionQuestionResult.ScreenShot[] | 意愿核身问答模式屏幕截图 | 数组中所有项目都会返回 COS 路径 |
Response.IntentionQuestionResult.Audios[] | 意愿核身问答模式答案录音音频 | 数组中所有项目都会返回 COS 路径 |
Response.IntentionActionResult.Details[0].Video | 意愿核身点头模式视频（其中包含全程提示文本和点头音频，mp4格式） | IntentionActionResult.Details 只有一个项目 |
Response.IntentionActionResult.Details[0].ScreenShot[] | 意愿核身点头模式屏幕截图 | 数组中所有项目都会返回 COS 路径 |
Response.IntentionVerifyData.IntentionVerifyVideo | 意愿核身朗读模式录制的视频 | 注意：此字段不支持自定义存储，会原样返回base64 |
Response.IntentionVerifyData.IntentionVerifyBestFrame | 意愿核身朗读模式录制视频的最佳帧 | 注意：此字段不支持自定义存储，会原样返回base64 |
