Visuelle Verifizierungssitzung erstellen

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

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

Speichern Sie Result.BytedToken und öffnen Sie Result.H5Link für die zu verifizierende Person.
Hängen Sie zur Auswahl der H5-Sprache lng an H5Link an, zum Beispiel &lng=en. Die Sprache ist kein Feld des Anforderungstexts.
Nach Abschluss des H5-Ablaufs öffnet der Browser Result.CallbackURL. Die Callback-Abfrage kann bytedToken, resultCode, algorithmBaseRespCode, reqMeasureInfoValue und verify_type enthalten.
Rufen Sie Visuelles Verifizierungsergebnis abrufen 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

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

{
  "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.

Videostatus abrufen Visuelles Verifizierungsergebnis abrufen

Kern

Text & Chat

Dateien & Batch-Jobs

Bilder

Audio & Echtzeit

Musik

Video & Materialien

Worlds

3D

Asynchrone Jobs

Gemini nativ

Verwaltung

Visuelle Verifizierungssitzung erstellen

Endpunkt und Authentifizierung

Ablauf

Beispielanfrage

Beispielantwort

​Endpunkt und Authentifizierung

​Ablauf

​Beispielanfrage

​Beispielantwort

Endpunkt und Authentifizierung

Ablauf

Beispielanfrage

Beispielantwort