Tạo phiên xác thực trực quan

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

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

Không chấp nhận chữ ký AK/SK của Volc. CallbackURL là trường bắt buộc và phải là URL HTTPS công khai. ProjectName là trường tùy chọn, mặc định là default.

Quy trình

Lưu Result.BytedToken và mở Result.H5Link cho người cần xác thực.
Để chọn ngôn ngữ H5, thêm lng vào H5Link, ví dụ &lng=en. Ngôn ngữ không phải là trường trong nội dung yêu cầu.
Sau khi quy trình H5 hoàn tất, trình duyệt sẽ mở Result.CallbackURL. Truy vấn callback có thể chứa bytedToken, resultCode, algorithmBaseRespCode, reqMeasureInfoValue và verify_type.
Thăm dò Lấy kết quả xác thực trực quan bằng BytedToken đã lưu cho đến khi trả về Result.GroupId.

BytedToken có hiệu lực trong 30 phút và gắn với tổ chức đã xác thực cùng ProjectName. Liên kết H5 chỉ cho phép hoàn tất một lần xác thực và sẽ hết hiệu lực sau khi sử dụng. Hãy coi Result.H5Link là URL trình duyệt không trong suốt: mở URL này dưới dạng trang cấp cao nhất và không phân tích, giải mã, viết lại hoặc nhúng URL. TokenLab quản lý việc 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"
  }
}

Lỗi dùng cùng cấu trúc cấp cao nhất. Hãy đọc ResponseMetadata.Error.Code và ResponseMetadata.Error.Message thay vì các trường lỗi của những API /v1 khác của TokenLab.

Lấy trạng thái video Lấy kết quả xác thực trực quan

Cốt lõi

Văn bản

Tệp và lô

Hình ảnh

Âm thanh & thời gian thực

Âm nhạc

Video & tư liệu

Worlds

3D

Tác vụ bất đồng bộ

Gemini gốc

Quản lý

Tạo phiên xác thực trực quan

Endpoint và xác thực

Quy trình

Ví dụ yêu cầu

Ví dụ phản hồi

​Endpoint và xác thực

​Quy trình

​Ví dụ yêu cầu

​Ví dụ phản hồi

Endpoint và xác thực

Quy trình

Ví dụ yêu cầu

Ví dụ phản hồi