> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Visuelle Verifizierungssitzung erstellen

> Erstellt eine Volc-kompatible Sitzung zur visuellen Verifizierung einer echten Person.

Erstellen Sie vor dem Hochladen wiederverwendbarer `liveness_face`-Materialien eine visuelle Verifizierungssitzung. TokenLab verwendet das Format der Volc Action API und die Bearer-Authentifizierung von TokenLab.

## Endpunkt und Authentifizierung

```text theme={null}
POST https://api.tokenlab.sh/api/v3?Action=CreateVisualValidateSession&Version=2024-01-01
Authorization: Bearer <TOKENLAB_API_KEY>
Content-Type: application/json
```

Volc-AK/SK-Signaturen werden nicht akzeptiert. `CallbackURL` ist erforderlich und muss eine öffentliche HTTPS-URL sein. `ProjectName` ist optional und hat den Standardwert `default`.

## Ablauf

1. Speichern Sie `Result.BytedToken` und öffnen Sie `Result.H5Link` für die zu verifizierende Person.
2. Hängen Sie zur Auswahl der H5-Sprache `lng` an `H5Link` an, zum Beispiel `&lng=en`. Die Sprache ist kein Feld des Anforderungstexts.
3. Nach Abschluss des H5-Ablaufs öffnet der Browser `Result.CallbackURL`. Die Callback-Abfrage kann `bytedToken`, `resultCode`, `algorithmBaseRespCode`, `reqMeasureInfoValue` und `verify_type` enthalten.
4. Rufen Sie [Visuelles Verifizierungsergebnis abrufen](/de/api-reference/video/get-visual-validation-result) wiederholt mit dem gespeicherten `BytedToken` auf, bis `Result.GroupId` zurückgegeben wird.

`BytedToken` ist 30 Minuten gültig und an die authentifizierte Organisation sowie `ProjectName` gebunden. Der H5-Link erlaubt eine abgeschlossene Verifizierung und wird danach ungültig.

Behandeln Sie `Result.H5Link` als undurchsichtige Browser-URL: Öffnen Sie sie als Seite der obersten Ebene und analysieren, decodieren, verändern oder betten Sie sie nicht ein. TokenLab verwaltet die Browser-Weiterleitung und die Callback-Brücke.

## Beispielanfrage

```bash theme={null}
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"}'
```

## Beispielantwort

```json theme={null}
{
  "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"
  }
}
```

Fehler verwenden dieselbe oberste Struktur. Lesen Sie `ResponseMetadata.Error.Code` und `ResponseMetadata.Error.Message` statt der Fehlerfelder anderer TokenLab-`/v1`-APIs.