TokenLab
API 키 받기
문서API 레퍼런스통합

비디오 및 자료

시각 인증 결과 조회

시각 인증으로 생성된 실제 인물 자료 그룹을 조회합니다.

POST
/api/v3

H5 시각 인증 흐름 이후 이 Action을 폴링합니다. 성공하면 인증된 인물의 TokenLab 자료 그룹 ID가 반환됩니다.

세션을 생성한 것과 동일한 인증된 조직, 사용자 및 대소문자를 구분하는 ProjectName을 사용하세요.

엔드포인트 및 인증

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

시각 인증 세션 생성에서 반환된 BytedToken을 전송합니다. 생성 시 ProjectName을 설정했다면 대소문자를 구분하여 같은 값을 전송하고, 그렇지 않으면 생략하거나 default를 사용합니다.

브라우저 콜백 직후에는 결과가 준비되지 않을 수 있습니다. Result.GroupId가 반환되거나 30분 유효한 BytedToken이 만료될 때까지 같은 요청을 재시도하십시오. 같은 token으로 성공한 요청을 반복하면 동일한 GroupId가 반환됩니다.

liveness_face 자료를 생성할 때 반환된 GroupId를 group_id로 사용합니다.

요청 예시

curl 'https://api.tokenlab.sh/api/v3?Action=GetVisualValidateResult&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"BytedToken":"ZXhhbXBsZS10b2tlbg","ProjectName":"default"}'

응답 예시

{
  "ResponseMetadata": {
    "RequestId": "req_def456",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "GroupId": "group-20260720123456-real1"
  }
}

오류에는 ResponseMetadata.Error.Code와 ResponseMetadata.Error.Message가 사용됩니다. 성공 응답에는 ResponseMetadata와 Result가 포함되며 TokenLab의 다른 /v1 API 응답 형식을 사용하지 않습니다.

curl -X POST "https://example.com/api/v3" \  -H "Content-Type: application/json" \  -d '{    "CallbackURL": "http://example.com"  }'
{  "id": "string"}

인증

BearerAuth
AuthorizationBearer <token>

API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.

위치: header

쿼리 매개변수

Action?string

허용 값

  • "CreateContentsGenerationsTasks"
  • "GetContentsGenerationsTask"
  • "ListContentsGenerationsTasks"
  • "DeleteContentsGenerationsTasks"
  • "CreateVisualValidateSession"
  • "GetVisualValidateResult"
  • "CreateAssetGroup"
  • "ListAssetGroups"
  • "GetAssetGroup"
  • "UpdateAssetGroup"
  • "DeleteAssetGroup"
  • "CreateAsset"
  • "ListAssets"
  • "GetAsset"
  • "UpdateAsset"
  • "DeleteAsset"
Version?string
기본값"2024-01-01"

헤더

X-TokenLab-Delivery-Policy?string

요청별 전송 정책입니다. API 키 및 Workspace 기본값을 재정의합니다. 자동으로 TokenLab Verified를 먼저 시도하며, 출력, 요청 수락 또는 영구 리소스 생성 전에 Official 전용으로 한 번 전환될 수 있습니다.

허용 값

  • "auto"
  • "verified"
  • "official"

요청 본문

application/json

응답

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

시각 인증 세션 생성

이전

소재 Action(Volcengine 호환)

다음