Skip to main content
POST
자산 그룹 생성(실인물)

소개

실인물 자산 그룹(group_type: liveness_face)은 자산 그룹 생성으로 생성할 수 없습니다. 먼저 이 엔드포인트를 호출하여 H5 생체 인증을 시작하세요. 사용자가 검증을 완료하면 게이트웨이가 그룹을 저장합니다. 가상 및 실인물 라이브러리 각각 사용자당 최대 100개 그룹(별도 할당량). 검증 후 이미지/비디오/오디오 자산 추가는 자산 생성을 통해 가상 라이브러리와 동일하게 작동합니다—추가 얼굴 매칭 없음(초기 그룹 생성 시에는 실인물 얼굴 검증 필요).
BytePlus CreateVisualValidateSessionname 또는 description을 받지 않습니다. 업스트림 GroupId를 받은 후 게이트웨이가 UpdateAssetGroup을 호출하여 해당 필드를 BytePlus 콘솔에 다시 기록합니다.

인증

string
필수
Bearer Token, 예: Bearer sk-xxxxxxxxxx
string
application/json

요청 본문

string
필수
자산 그룹 이름(저장되고 BytePlus 콘솔에 동기화됨)
string
설명; 생략하거나 비어 있으면 API 키 사용자 username이 기본값으로 사용됩니다(자산 그룹 생성과 동일)
integer
업스트림 채널 ID; 생략 시 자동 선택

H5 검증 흐름

애플리케이션은 POST /v1/visual-validate/result직접 호출할 필요가 없습니다. 게이트웨이 콜백 페이지가 state를 자동으로 전달합니다.

예제

응답

클라이언트는 일반적으로 팝업에서 h5_link를 열고 window.message를 수신하기만 하면 됩니다. H5 타임아웃 시 팝업을 닫고 리스너를 제거한 후 POST /v1/visual-validate/session을 다시 호출하여 새 링크를 받으세요. 클라이언트 측 타임아웃 약 130초를 대비책으로 고려하세요.

클라이언트 postMessage

콜백 페이지(/asset-validate-callback.html)가 window.opener에 메시지를 전송합니다(targetOrigin = '*'). 콜백 페이지와 부모가 다른 출처인 경우 event.origin만 의존하지 말고 type으로 메시지를 식별하세요. 성공:
실패:
최소 통합 예제:

다음 단계

  1. postMessage의 group_id 사용( 엔드포인트의 동기 응답이 아님)하여 자산 생성 호출
  2. 자산 목록 조회 또는 자산 조회status: active까지 폴링
  3. 비디오 생성 작업 생성에서 asset://로 자산 참조
자산 그룹 목록 조회(?group_type=liveness_face)로 그룹 생성을 확인할 수도 있습니다.