TokenLab

비디오 및 자료

시각적 검증 세션 생성

Volc 호환 실사용자 시각적 검증 세션을 생성합니다.

POST
/api/v3

재사용 가능한 liveness_face 자료를 업로드하기 전에 실사용자 시각적 검증 세션을 생성하십시오. TokenLab은 Volc Action API 형태와 TokenLab Bearer 인증을 사용합니다.

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

세션 생성 직후 Result.H5Link를 여십시오. 초기 실행은 30분인 BytedToken보다 먼저 만료될 수 있으므로, 여는 것을 지체하지 마십시오.

엔드포인트 및 인증

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입니다.

흐름

  1. Result.BytedToken을 저장하고 검증 대상자를 위해 Result.H5Link를 엽니다.
  2. H5 언어를 선택하려면 H5Link에 lng를 추가하십시오. 예: &lng=en. 언어는 요청 본문 필드가 아닙니다.
  3. H5 흐름이 완료되면 브라우저가 Result.CallbackURL을 엽니다. 콜백 쿼리에는 bytedToken, resultCode, algorithmBaseRespCode, reqMeasureInfoValue 및 verify_type이 포함될 수 있습니다.
  4. Result.GroupId가 반환될 때까지 저장된 BytedToken으로 시각적 검증 결과 가져오기를 폴링하십시오.

BytedToken은 30분 동안 유효하며 인증된 조직 및 ProjectName으로 범위가 지정됩니다. H5 링크는 1회의 완료된 인증을 지원하며 사용 후에는 무효화됩니다.

Result.H5Link를 불투명한 브라우저 URL로 취급하십시오. 최상위 페이지로 열고, 파싱, 디코딩, 재작성 또는 임베드하지 마십시오. 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"
  }
}

안전한 재시도

응답을 받지 못한 경우 복구할 수 있도록 선택적 Idempotency-Key 헤더(1~255자)를 전송하십시오. 동일한 키, API 키, CallbackURL 및 ProjectName으로 재시도하면 동일한 BytedToken 및 H5Link가 반환됩니다. 다른 요청에 동일한 키를 사용하면 409 IdempotencyConflict가 반환됩니다. 첫 번째 요청이 여전히 생성 중인 경우, 응답은 409 RequestInProgress와 함께 Retry-After: 2가 반환됩니다. 잘못된 키는 400 InvalidParameter를 반환합니다.

오류

오류는 동일한 최상위 엔벨로프를 사용합니다. TokenLab의 다른 /v1 API 필드를 기대하는 대신 ResponseMetadata.Error.Code 및 ResponseMetadata.Error.Message를 읽으십시오.

상태코드원인
400InvalidParameter누락되었거나 잘못된 CallbackURL(자격 증명이 없는 공개 HTTPS URL이어야 함), 잘못된 Idempotency-Key 또는 알 수 없는 필드
400InvalidVersionVersion이 2024-01-01이 아님
405MethodNotAllowed해당 Action은 POST만 허용함
409IdempotencyConflict, RequestInProgress안전한 재시도 섹션 참조
503ServiceUnavailable이 계정에 대해 실사용자 검증을 사용할 수 없거나 실패함; 나중에 다시 시도하십시오
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