시각 인증 세션 생성

재사용 가능한 liveness_face 자료를 업로드하기 전에 실제 인물 시각 인증 세션을 생성합니다. TokenLab은 Volc Action API 형식과 TokenLab Bearer 인증을 사용합니다.

엔드포인트 및 인증

POST https://api.tokenlab.sh/api/v3?Action=CreateVisualValidateSession&Version=2024-01-01
Authorization: Bearer <TOKENLAB_API_KEY>
Content-Type: application/json

Volc AK/SK 서명은 허용되지 않습니다. CallbackURL은 필수이며 공개 HTTPS URL이어야 합니다. ProjectName은 선택 사항이며 기본값은 default입니다.

흐름

Result.BytedToken을 저장하고 인증 대상자가 Result.H5Link를 열도록 합니다.
H5 언어를 지정하려면 H5Link에 lng를 추가합니다(예: &lng=en). 언어는 요청 본문 필드가 아닙니다.
H5 흐름이 완료되면 브라우저가 Result.CallbackURL을 엽니다. 콜백 쿼리에는 bytedToken, resultCode, algorithmBaseRespCode, reqMeasureInfoValue, verify_type가 포함될 수 있습니다.
저장한 BytedToken으로 시각 인증 결과 조회를 폴링하여 Result.GroupId가 반환될 때까지 기다립니다.

BytedToken은 30분 동안 유효하며 인증된 조직 및 ProjectName에 귀속됩니다. H5 링크에서는 한 번의 인증만 완료할 수 있으며 사용 후에는 무효화됩니다. Result.H5Link는 불투명한 브라우저 URL로 취급하여 최상위 페이지로 여세요. URL을 파싱, 디코딩, 재작성하거나 임베드하지 마세요. 브라우저 핸드오프와 callback 브리지는 TokenLab이 관리합니다.

요청 예시

curl 'https://api.tokenlab.sh/api/v3?Action=CreateVisualValidateSession&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"CallbackURL":"https://yourapp.example.com/seedance/callback","ProjectName":"default"}'

응답 예시

{
  "ResponseMetadata": {
    "RequestId": "req_abc123",
    "Action": "CreateVisualValidateSession",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "BytedToken": "ZXhhbXBsZS10b2tlbg",
    "H5Link": "https://api.tokenlab.sh/api/v3/visual-validation/sessions/svv_example/h5?Version=2024-01-01",
    "CallbackURL": "https://yourapp.example.com/seedance/callback"
  }
}

오류도 동일한 최상위 형식을 사용합니다. TokenLab의 다른 /v1 API 필드 대신 ResponseMetadata.Error.Code와 ResponseMetadata.Error.Message를 확인하십시오.

비디오 상태 가져오기 시각 인증 결과 조회

핵심

텍스트

파일 및 배치

이미지

오디오 및 실시간

음악

비디오 및 자료

Worlds

3D

비동기 작업

Gemini 네이티브

관리

시각 인증 세션 생성

엔드포인트 및 인증

흐름

요청 예시

응답 예시

​엔드포인트 및 인증

​흐름

​요청 예시

​응답 예시

엔드포인트 및 인증

흐름

요청 예시

응답 예시