本文中含有需要您注意的重要提示信息，忽略該信息可能對您的業務造成影響，請務必仔細閱讀。
本文介紹了如何通過InitFaceVerify接口進行活體人臉驗證。
傳入圖片格式要求
當您的終端用戶在進行實人認證的時候，請確保傳入的照片滿足以下所有條件：
近期照片，人臉完整清晰無遮擋，表情自然，正對攝像頭，角度無太大偏差。
照片清晰、曝光正常，臉部無過黑、過亮、光暈等情況。
照片的分辨率不超過1920*1080（高*寬），不低于640*480（高*寬），且照片的高大于寬。推薦短邊縮放到720像素，壓縮率大于0.9。
照片小于1 MB。
照片支持順時針旋轉90°、180°和270°。
照片中有且只有一張人臉。
說明如果一張照片中存在多張人臉，默認會選取面積最大的人臉進行驗證。
正確的圖片示例：
發起認證請求
接口名：InitFaceVerify。
全局接入地址：cloudauth.aliyuncs.com（IPv4）或cloudauth-dualstack.aliyuncs.com（IPv6）
請求方法：POST和GET。
傳輸協議：HTTPS。
接口說明：每次開始認證前通過本接口獲取CertifyId，用來串聯認證請求中的各個接口。
QPS限量：API獨享QPS限量，詳情請參見服務端接口QPS限量說明。
請求參數
名稱 | 類型 | 是否必選 | 描述 | 示例值 |
SceneId | Long | 是 | 認證場景ID。該ID在控制臺創建認證場景后自動生成。關于如何創建認證場景，請參見添加認證場景。 | 100000**** |
OuterOrderNo | String | 是 | 您自定義的業務唯一標識，用于后續定位排查問題使用。 值最長為32位長度的字母和數字組合，請確保唯一。 | e0c34a77f5ac40a5aa5e6ed20c35**** |
ProductCode | String | 是 | 認證方案。 唯一取值：PV_FV。 | PV_FV |
Model | String | 否 | 活體檢測類型。取值：
說明
| MOVE_ACTION |
UserId | String | 是 | 您自定義的用戶ID（最長100個字符），請保持唯一。 | 12345**** |
CertType | String | 否 | 證件類型。 當前僅支持身份證。唯一取值：IDENTITY_CARD。 說明 該方案中，不驗證姓名和證件號碼的真實性、一致性。如需驗證，請選擇實人認證方案。 | IDENTITY_CARD |
CertName | String | 否 | 您的終端用戶的真實姓名。 | 張三 |
CertNo | String | 否 | 您的終端用戶的證件號碼。 | 33010312345678**** |
MetaInfo | String | 是 | MetaInfo環境參數。需要通過客戶端SDK獲取，詳情請參見App（SDK）接入。 | {"zimVer":"3.0.0","appVersion": "1","bioMetaInfo": "4.1.0:1150****,0","appName": "com.aliyun.antcloudauth","deviceType": "ios","osVersion": "iOS 10.3.2","apdidToken": "","deviceModel": "iPhone9,1"} 重要 該示例僅供參考，實際集成中不能直接應用，具體參考SDK集成說明獲取。 |
Mobile | String | 否 | 您的終端用戶的手機號碼。 | 1304567**** |
Ip | String | 否 | 您的終端用戶的IP。 | 114.112.xx.xx |
FaceContrastPicture | String | 否 金融級活體人臉驗證方案提供四種傳入人臉照片的方式，請您選擇其中一種。
| 照片Base64編碼。如果您選擇FaceContrastPicture（照片Base64編碼）方式傳入人臉照片，請注意檢查照片大小，不要傳入過大的照片。 說明 如果您需要上傳較大的人臉照片，請選擇OSS方式。 | /9j/4AAQSkZJRgABAQAASASBC**** |
FaceContrastPictureUrl | String | 人像地址，公網可訪問的HTTP、HTTPS鏈接。 | https://cn-shanghai-aliyun-cloudauth-****.oss-cn-shanghai.aliyuncs.com/verify/****.jpeg | |
CertifyId | String | 如果您之前已經通過實人認證，可使用實人認證唯一標識CertifyId，認證時的照片作為人臉比對照片。 說明 您需要確保傳入CertifyId關聯的圖片正常存儲在授權的OSS Bucket中。 | 0bfa7c493f850e5178b9f8613634**** | |
OssBucketName | String | 已授權OSS的存儲空間（Bucket）名稱。如果您選擇OSS方式傳入人臉照片，您必須傳入OssBucketName和OssObjectName參數。OSS請求參數格式僅支持開通實人認證服務時授權的OSS生成的URL、Bucket和文件名。 | cn-shanghai-aliyun-cloudauth-**** | |
OssObjectName | String | 已授權OSS存儲空間的文件（Object）名稱。如果您選擇OSS方式傳入人臉照片，您必須傳入OssBucketName和OssObjectName參數。OSS請求參數格式僅支持開通實人認證服務時授權的OSS生成的URL、Bucket和文件名。 | verify/****.jpeg | |
CallbackUrl | String | 否 | 認證結果的回調通知地址，回調請求方式默認為GET，回調地址必須以 說明 僅當認證完成（包含認證通過和認證未通過）時才會觸發回調，若認證中放棄、異常中斷或未進行認證均不會通知。建議您收到回調通知時，若有需要可通過查詢接口獲取認證詳情信息。 | https://www.aliyun.com |
CallbackToken | String | 否 | 安全Token，由您自行生成，用于防重復、防篡改校驗。 如果設置了該值會在回調地址顯示CallbackToken字段。 | NMjvQanQgplBSaEI0sL86WnQplB |
Crop | String | 否 | 是否允許裁剪人臉圖片，默認不允許。
說明 若您請求的圖片并非來自標準活體檢測SDK采集，建議您允許裁剪人臉圖片。 開啟該功能后，將會對請求的圖片先進行人臉裁剪與矯正，完成后會發起請求服務。 | T |
AuthId | String | 否 | 用戶授權ID，最大長度為64位字符。 | 92d46b9e9e2d703f2897f350d5bd4149 |
SuitableType | String | 否 | 適老化配置參數，針對每筆認證請求生效，您可以根據自有App的業務屬性、客群分布、操作特性等條件對于每筆認證請求選擇不同的參數，包括以下選項，默認為0。
說明
| 0 |
FaceGuardOutput | String | 否 | 人臉保鏢標簽種類。 DeviceRisk：設備風險標簽。
說明 | DeviceRisk |
AppQualityCheck | String | 否 | SDK是否開啟人臉嚴格質量檢測。
說明
| N |
OSS入參格式僅支持開通實人認證服務時授權的OSS生成的URL、Bucket和文件名 。關于如何查詢授權的OSS，請參見接入流程 。
如果您選擇FaceContrastPicture（照片Base64編碼）方式傳入人臉照片，請注意檢查照片大小，不要傳入過大的照片；您可以通過OSS方式上傳較大的人臉照片。
返回數據
名稱 | 類型 | 是否必選 | 描述 | 示例值 |
RequestId | String | 是 | 本次請求的ID。 | 130A2C10-B9EE-4D84-88E3-5384FF03**** |
Message | String | 否 | 請求消息的響應信息。 | success |
Code | String | 是 | 返回碼。關于返回碼的具體內容，請參見返回Code和Message說明。 | 200 |
ResultObject.CertifyId | String | 否 | 實人認證唯一標識。 警告 CertifyId字段為計費統計字段，為了方便后續核對賬單，請您在本地留存該字段信息。 初始化接口返回的認證CertifyId在30分鐘有效且僅能認證提交一次，請您在有效期內應用，避免重復使用。 | 91707dc296d469ad38e4c5efa6a0**** |
返回Code和Message說明
Code | Message | 描述 |
200 | success | 成功。 |
400 | 參數不能為空 | 參數不能為空。 |
401 | 參數非法 | 非法參數。傳入的姓名、身份證號碼長度必須符合國家標準且不得包含英文字母等特殊字符。 |
402 | 應用配置不存在 | 應用配置不存在。 |
404 | 認證場景配置不存在 | 認證場景配置不存在，請先在控制臺上創建認證場景。 |
410 | 未開通服務 | 未開通OSS產品或未完成OSS讀寫授權，請登錄金融級實人認證控制臺完成授權。具體操作，請參見授權金融級實人認證訪問OSS存儲空間 |
411 | RAM無權限 | 需要給RAM賬號授予AliyunAntCloudAuthFullAccess的操作權限。 |
412 | 欠費中 | 金融級實人認證或OSS存在欠費，請充值后操作。 |
414 | 設備類型不支持 | 當前移動設備不支持刷臉認證，請更換設備后操作。 |
415 | SDK版本不支持 | 當前認證SDK版本不支持刷臉認證，請升級SDK后操作。 |
416 | 系統版本不支持 | 當前操作系統版本不支持刷臉認證，請升級系統或更換設備操作。 |
417 | 無法使用刷臉服務 | 自定義比對源的圖片人臉特征提取失敗，建議更換圖片上傳。 |
418 | 刷臉失敗次數過多 | 當天刷臉認證次數過多，請明天再試。 |
419 | 傳入圖片不可用 | 圖片無法下載、圖片內容為空或圖片分辨率不符合要求。 |
420 | 數據重復 | 圖片傳入方式超過了一種。 支持以下四種傳入人臉照片的方式，必須且只能使用其中一種：
|
421 | 傳入圖片過大 | 圖片超過了1 MB，建議壓縮圖片或更換圖片上傳方式。 |
422 | 下載圖片超時 | 圖片下載超過了3秒，請排查網絡后重新操作。 |
423 | 狀態錯誤 | 傳入的CertifyId認證狀態需要為T（認證通過），您也可以更換其他方式傳入圖片。 |
500 | 系統錯誤 | 系統內部錯誤，請反饋工程師排查。 |