視頻與素材
取得視覺驗證結果
取得由視覺驗證所產生的真人素材群組。
在 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 的回應封裝格式。
| 狀態 | 代碼 | 原因 |
|---|---|---|
400 | InvalidParameter | BytedToken 無效或已過期、ProjectName 不符,或驗證尚未完成(請重試) |
400 | InvalidVersion | Version 不是 2024-01-01 |
405 | MethodNotAllowed | 此 Action 僅接受 POST |
409 | Conflict | 已驗證的群組已對應至另一個組織 |
503 | ServiceUnavailable | 真人驗證服務不可用或請求失敗;請稍後重試 |
curl -X POST "https://example.com/api/v3" \ -H "Content-Type: application/json" \ -d '{ "CallbackURL": "http://example.com" }'{ "id": "string"}授權
BearerAuth API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。
位置: header
查詢參數
可選值
- "CreateContentsGenerationsTasks"
- "GetContentsGenerationsTask"
- "ListContentsGenerationsTasks"
- "DeleteContentsGenerationsTasks"
- "CreateVisualValidateSession"
- "GetVisualValidateResult"
- "CreateAssetGroup"
- "ListAssetGroups"
- "GetAssetGroup"
- "UpdateAssetGroup"
- "DeleteAssetGroup"
- "CreateAsset"
- "ListAssets"
- "GetAsset"
- "UpdateAsset"
- "DeleteAsset"
"2024-01-01"請求標頭
單次請求傳遞策略。會覆寫 API key 與 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