TokenLab

Vidéo & ressources

Créer une session de validation visuelle

Crée une session de validation visuelle de personne réelle compatible avec Volc.

POST
/api/v3

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/json

La 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

  1. Enregistrez Result.BytedToken et ouvrez Result.H5Link pour la personne en cours de vérification.
  2. 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.
  3. Une fois le flux H5 terminé, le navigateur ouvre Result.CallbackURL. La requête de rappel peut contenir bytedToken, resultCode, algorithmBaseRespCode, reqMeasureInfoValue et verify_type.
  4. Interrogez Obtenir le résultat de validation visuelle avec le BytedToken enregistré jusqu'à ce que Result.GroupId soit 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.

StatutCodeCause
400InvalidParameterCallbackURL manquant ou invalide (doit être une URL HTTPS publique sans identifiants), Idempotency-Key invalide, ou champ inconnu
400InvalidVersionVersion n'est pas 2024-01-01
405MethodNotAllowedL'Action accepte uniquement POST
409IdempotencyConflict, RequestInProgressVoir Réessayer En Toute Sécurité
503ServiceUnavailableLa 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
AuthorizationBearer <token>

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

Action?string

Valeurs possibles

  • "CreateContentsGenerationsTasks"
  • "GetContentsGenerationsTask"
  • "ListContentsGenerationsTasks"
  • "DeleteContentsGenerationsTasks"
  • "CreateVisualValidateSession"
  • "GetVisualValidateResult"
  • "CreateAssetGroup"
  • "ListAssetGroups"
  • "GetAssetGroup"
  • "UpdateAssetGroup"
  • "DeleteAssetGroup"
  • "CreateAsset"
  • "ListAssets"
  • "GetAsset"
  • "UpdateAsset"
  • "DeleteAsset"
Version?string
par défaut"2024-01-01"

En-têtes

X-TokenLab-Delivery-Policy?string

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