실제 인물 검증 세션 시작

curl --request POST \
  --url https://api.orcarouter.ai/v1/asset/real-human/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "return_url": "https://your-app.com/verify/done"
}
'

{
  "session_id": "Xa9f...40-char-token",
  "h5_link": "https://verify.example.com/?session=...",
  "status": "pending"
}

Seedance Assets

실제 인물 검증 세션 시작

실제 인물(LivenessFace) 에셋 그룹 생성을 시작합니다. 최종 사용자가 열어서 일회성 얼굴 검증을 완료하는 H5 링크를 반환합니다. 사용자가 완료한 후, 검증 페이지가 그 브라우저를 OrcaRouter 콜백으로 리디렉션하고(귀하를 위해 처리됨), 새 그룹이 등록됩니다. 결과는 GET /asset/real-human/sessions/{session_id} 를 폴링하세요. 최종 사용자의 기기는 로그인되어 있을 필요가 없습니다.

POST

asset

real-human

sessions

실제 인물 검증 세션 시작

curl --request POST \
  --url https://api.orcarouter.ai/v1/asset/real-human/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "return_url": "https://your-app.com/verify/done"
}
'

{
  "session_id": "Xa9f...40-char-token",
  "h5_link": "https://verify.example.com/?session=...",
  "status": "pending"
}

인증

Authorization

string

header

필수

OrcaRouter API 키는 sk-orca-...처럼 보입니다. Authorization: Bearer sk-orca-... 헤더로 전달하세요.

본문

application/json

return_url 외의 모든 필드는 상위 검증 호출로 그대로 전달되므로, 에셋 서비스가 지원하는 모든 파라미터를 전달할 수 있습니다. CallbackURL 과 ProjectName 은 OrcaRouter가 설정하며 덮어쓸 수 없습니다.

return_url

string

선택 사항인 http(s) URL로, 검증 후 최종 사용자의 브라우저를 여기로 리디렉션하며 ?status=&session_id=&group_id= 를 함께 붙입니다. 생략하면 내장 완료 페이지가 표시됩니다.

응답

200 - application/json

세션 생성됨

session_id

string

h5_link

string

status

string

에셋 삭제 실제 인물 검증 세션 폴링(id로)