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.
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/jsonViệ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
- Lưu
Result.BytedTokenvà mởResult.H5Linkcho người cần xác minh. - Để chọn ngôn ngữ H5, hãy thêm
lngvàoH5Link, 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). - 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ứabytedToken,resultCode,algorithmBaseRespCode,reqMeasureInfoValue, vàverify_type. - 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 khiResult.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ái | Mã | Nguyên nhân |
|---|---|---|
400 | InvalidParameter | Thiế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 |
400 | InvalidVersion | Version không phải là 2024-01-01 |
405 | MethodNotAllowed | Action này chỉ chấp nhận POST |
409 | IdempotencyConflict, RequestInProgress | Xem phần Thử lại An toàn |
503 | ServiceUnavailable | Xá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 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
Giá trị hợp lệ
- "CreateContentsGenerationsTasks"
- "GetContentsGenerationsTask"
- "ListContentsGenerationsTasks"
- "DeleteContentsGenerationsTasks"
- "CreateVisualValidateSession"
- "GetVisualValidateResult"
- "CreateAssetGroup"
- "ListAssetGroups"
- "GetAssetGroup"
- "UpdateAssetGroup"
- "DeleteAssetGroup"
- "CreateAsset"
- "ListAssets"
- "GetAsset"
- "UpdateAsset"
- "DeleteAsset"
"2024-01-01"Header
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