TokenLab

Video & tư liệu

Tạo Phiên Xác thực Trực quan

Tạo một phiên xác thực trực quan người thật tương thích với Volc.

POST
/api/v3

Tạo phiên xác thực trực quan người thật trước khi tải lên các tài liệu liveness_face có thể tái sử dụng. TokenLab sử dụng định dạng Volc Action API và xác thực TokenLab Bearer.

Sử dụng cùng tổ chức, người dùng và ProjectName (phân biệt chữ hoa chữ thường) đã được xác thực để tạo phiên.

Mở Result.H5Link ngay lập tức sau khi tạo phiên. Lần khởi chạy ban đầu của nó có thể hết hạn trước thời hạn 30 phút của BytedToken; đừng trì hoãn việc mở liên kết này.

Endpoint Và Xác thực

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

Việc ký Volc AK/SK không được chấp nhận. CallbackURL là bắt buộc và phải là một URL HTTPS công khai. ProjectName là tùy chọn và mặc định là default.

Quy trình

  1. Lưu Result.BytedToken và mở Result.H5Link cho người cần xác minh.
  2. Để chọn ngôn ngữ H5, hãy thêm lng vào H5Link, ví dụ &lng=en. Ngôn ngữ không phải là một trường trong phần thân yêu cầu (request-body).
  3. Sau khi quy trình H5 kết thúc, trình duyệt sẽ mở Result.CallbackURL. Truy vấn callback có thể chứa bytedToken, resultCode, algorithmBaseRespCode, reqMeasureInfoValue, và verify_type.
  4. Thực hiện gọi Lấy kết quả xác thực trực quan với BytedToken đã lưu cho đến khi Result.GroupId được trả về.

BytedToken có hiệu lực trong 30 phút và được giới hạn trong tổ chức và ProjectName đã xác thực. Liên kết H5 hỗ trợ một lần xác thực hoàn tất và sẽ trở nên không hợp lệ sau khi sử dụng.

Hãy coi Result.H5Link là một URL trình duyệt không thể can thiệp: mở nó dưới dạng trang cấp cao nhất, và không phân tích cú pháp, giải mã, viết lại hoặc nhúng nó. TokenLab sở hữu quy trình chuyển giao trình duyệt và cầu nối callback.

Ví dụ Yêu cầu

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"}'

Ví dụ Phản hồi

{
  "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"
  }
}

Thử lại An toàn

Gửi tiêu đề Idempotency-Key tùy chọn (1–255 ký tự) để có thể khôi phục nếu phản hồi bị mất. Việc thử lại với cùng một khóa, API key, CallbackURL và ProjectName sẽ trả về cùng một BytedToken và H5Link. Cùng một khóa với yêu cầu khác sẽ trả về 409 IdempotencyConflict. Trong khi yêu cầu đầu tiên vẫn đang được tạo, phản hồi sẽ là 409 RequestInProgress với Retry-After: 2. Một khóa không hợp lệ sẽ trả về 400 InvalidParameter.

Lỗi

Các lỗi sử dụng cùng một phong bì cấp cao nhất. Hãy đọc ResponseMetadata.Error.Code và ResponseMetadata.Error.Message thay vì mong đợi các trường từ các API /v1 khác của TokenLab.

Trạng tháiMãNguyên nhân
400InvalidParameterThiếu hoặc sai CallbackURL (phải là URL HTTPS công khai không có thông tin xác thực), Idempotency-Key không hợp lệ, hoặc một trường không xác định
400InvalidVersionVersion không phải là 2024-01-01
405MethodNotAllowedAction này chỉ chấp nhận POST
409IdempotencyConflict, RequestInProgressXem phần Thử lại An toàn
503ServiceUnavailableXác thực người thật không khả dụng cho tài khoản này hoặc đã thất bại; hãy thử lại sau
curl -X POST "https://example.com/api/v3" \  -H "Content-Type: application/json" \  -d '{    "CallbackURL": "http://example.com"  }'
{  "id": "string"}

Xác thực

BearerAuth
AuthorizationBearer <token>

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Vị trí: header

Tham số truy vấn

Action?string

Giá trị hợp lệ

  • "CreateContentsGenerationsTasks"
  • "GetContentsGenerationsTask"
  • "ListContentsGenerationsTasks"
  • "DeleteContentsGenerationsTasks"
  • "CreateVisualValidateSession"
  • "GetVisualValidateResult"
  • "CreateAssetGroup"
  • "ListAssetGroups"
  • "GetAssetGroup"
  • "UpdateAssetGroup"
  • "DeleteAssetGroup"
  • "CreateAsset"
  • "ListAssets"
  • "GetAsset"
  • "UpdateAsset"
  • "DeleteAsset"
Version?string
mặc định"2024-01-01"

Header

X-TokenLab-Delivery-Policy?string

Chính sách phân phối theo yêu cầu. Ghi đè các mặc định của API key và Workspace. Tự động thử TokenLab Verified trước và có thể chuyển đổi một lần sang Official chỉ trước khi xuất, chấp nhận yêu cầu hoặc tạo tài nguyên cố định.

Giá trị hợp lệ

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

Nội dung yêu cầu

application/json

Phản hồi

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json