Skip to main content

소개

H5 실인물 검증 세션을 시작합니다. 실인물 자산 그룹(GroupType = LivenessFace)은 CreateAssetGroup으로 생성할 수 없습니다(강제로 AIGC로 덮어씀). 이 흐름을 통해서만 생성할 수 있습니다. 가상 자산 라이브러리와 동일한 Asset/AssetGroup Action 세트를 공유합니다. 검증을 통과하고 GroupId를 받은 후, 추가/삭제/수정/조회는 AIGC와 완전히 동일합니다. 계정당 가상(AIGC) 자산 그룹 100개, 실인물(LivenessFace) 자산 그룹 100개(총 200개, 필요 시 한도 조정을 요청할 수 있음)까지 생성할 수 있습니다. 그룹당 100만개의 자산을 업로드할 수 있으며, 업로드 제한은 자산 생성을 참고하세요.
응답 형식이 다른 Action과 다릅니다: 원본 평면 구조이며 {ResponseMetadata, Result} 봉투가 아닙니다.
할당량 확인은 이 단계에서 수행됩니다: 상한 초과 시 403이 반환되며, ResponseMetadata.Error.Code = "QuotaExceeded", H5 검증 링크는 생성되지 않습니다.

요청 주소

POST

쿼리 파라미터

string
필수
작업 이름, 고정값 CreateVisualValidateSession
string
필수
버전, 고정값 2024-01-01

인증

string
필수
Bearer Token, 예: Bearer sk-your_token_key

요청 매개변수

string
어떤 값을 전달해도 고정된 콜백 페이지 주소로 강제 덮어씁니다 — 호출자가 지정한 임의 주소로 리디렉션되는 것을 방지합니다. GetVisualValidateResult는 Bearer 인증과 함께 동일 API를 사용하며, 콜백 페이지에 컨텍스트 전달에 의존하지 않습니다

요청 예제

응답 예제

실인물 자산 추가 제한

  • 할당량: 계정당 가상(AIGC) 자산 그룹 100개, 실인물(LivenessFace) 자산 그룹 100개(총 200개, 필요 시 한도 조정을 요청할 수 있음)까지 생성할 수 있습니다. 그룹당 100만개의 자산을 업로드할 수 있으며, 업로드 제한은 자산 생성을 참고하세요
  • 얼굴 매칭: 각 실인물 자산 그룹은 고유한 실제 인물에 대응; 업로드된 자산은 검증 참조 얼굴과 비교되며, 불일치 또는 다중 얼굴 시 Status: Failed
  • 삭제 제한: DeleteAssetGroup 참조