Vidéo & ressources
Créer une session de validation visuelle
Crée une session de validation visuelle de personne réelle compatible avec Volc.
Créez la session de validation visuelle de personne réelle avant de télécharger les matériaux liveness_face réutilisables. TokenLab utilise la structure de l'API Volc Action et l'authentification Bearer de TokenLab.
Utilisez la même organisation authentifiée, le même utilisateur et le même ProjectName sensible à la casse que ceux ayant créé la session.
Ouvrez Result.H5Link immédiatement après la création de la session. Son lancement initial peut expirer avant le BytedToken de 30 minutes ; ne tardez pas à l'ouvrir.
Endpoint Et Authentification
POST https://api.tokenlab.sh/api/v3?Action=CreateVisualValidateSession&Version=2024-01-01
Authorization: Bearer <TOKENLAB_API_KEY>
Content-Type: application/jsonLa signature AK/SK de Volc n'est pas acceptée. CallbackURL est requis et doit être une URL HTTPS publique. ProjectName est facultatif et défini par défaut sur default.
Flux
- Enregistrez
Result.BytedTokenet ouvrezResult.H5Linkpour la personne en cours de vérification. - Pour sélectionner la langue H5, ajoutez
lngàH5Link, par exemple&lng=en. La langue n'est pas un champ du corps de la requête. - Une fois le flux H5 terminé, le navigateur ouvre
Result.CallbackURL. La requête de rappel peut contenirbytedToken,resultCode,algorithmBaseRespCode,reqMeasureInfoValueetverify_type. - Interrogez Obtenir le résultat de validation visuelle avec le
BytedTokenenregistré jusqu'à ce queResult.GroupIdsoit renvoyé.
BytedToken est valide pendant 30 minutes et est limité à l'organisation authentifiée et au ProjectName. Le lien H5 prend en charge une authentification terminée et devient invalide après utilisation.
Traitez Result.H5Link comme une URL de navigateur opaque : ouvrez-la en tant que page de premier niveau, et ne l'analysez pas, ne la décodez pas, ne la réécrivez pas et ne l'intégrez pas. TokenLab gère le transfert vers le navigateur et le pont de rappel.
Exemple De Requête
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"}'Exemple De Réponse
{
"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"
}
}Réessayer En Toute Sécurité
Envoyez un en-tête Idempotency-Key facultatif (1 à 255 caractères) afin qu'une réponse perdue puisse être récupérée. Une nouvelle tentative avec la même clé, la même clé API, la même CallbackURL et le même ProjectName renvoie les mêmes BytedToken et H5Link. La même clé avec une requête différente renvoie 409 IdempotencyConflict. Pendant que la première requête est encore en cours de création, la réponse est 409 RequestInProgress avec Retry-After: 2. Une clé invalide renvoie 400 InvalidParameter.
Erreurs
Les erreurs utilisent la même enveloppe de premier niveau. Lisez ResponseMetadata.Error.Code et ResponseMetadata.Error.Message au lieu d'attendre les champs des autres API /v1 de TokenLab.
| Statut | Code | Cause |
|---|---|---|
400 | InvalidParameter | CallbackURL manquant ou invalide (doit être une URL HTTPS publique sans identifiants), Idempotency-Key invalide, ou champ inconnu |
400 | InvalidVersion | Version n'est pas 2024-01-01 |
405 | MethodNotAllowed | L'Action accepte uniquement POST |
409 | IdempotencyConflict, RequestInProgress | Voir Réessayer En Toute Sécurité |
503 | ServiceUnavailable | La validation de personne réelle est indisponible pour ce compte ou a échoué ; réessayez plus tard |
curl -X POST "https://example.com/api/v3" \ -H "Content-Type: application/json" \ -d '{ "CallbackURL": "http://example.com" }'{ "id": "string"}Autorisation
BearerAuth Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.
Emplacement: header
Paramètres de requête
Valeurs possibles
- "CreateContentsGenerationsTasks"
- "GetContentsGenerationsTask"
- "ListContentsGenerationsTasks"
- "DeleteContentsGenerationsTasks"
- "CreateVisualValidateSession"
- "GetVisualValidateResult"
- "CreateAssetGroup"
- "ListAssetGroups"
- "GetAssetGroup"
- "UpdateAssetGroup"
- "DeleteAssetGroup"
- "CreateAsset"
- "ListAssets"
- "GetAsset"
- "UpdateAsset"
- "DeleteAsset"
"2024-01-01"En-têtes
Politique de livraison par requête. Remplace les valeurs par défaut de la clé API et de l'espace de travail. Tente automatiquement TokenLab Verified en premier et peut basculer une fois vers Official uniquement avant la sortie, l'acceptation de la requête ou la création de ressource persistante.
Valeurs possibles
- "auto"
- "verified"
- "official"
Corps de la requête
application/json
Réponse
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json