> ## 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.

# Görsel doğrulama oturumu oluştur

> Volc uyumlu biçimde gerçek kişi görsel doğrulama oturumu oluşturur.

Yeniden kullanılabilir `liveness_face` materyallerini yüklemeden önce bir görsel doğrulama oturumu oluşturun. TokenLab, Volc Action API biçimini ve TokenLab Bearer kimlik doğrulamasını kullanır.

## Uç nokta ve kimlik doğrulama

```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 imzaları kabul edilmez. `CallbackURL` zorunludur ve herkese açık bir HTTPS URL’si olmalıdır. `ProjectName` isteğe bağlıdır ve varsayılan değeri `default` şeklindedir.

## Akış

1. `Result.BytedToken` değerini kaydedin ve doğrulanacak kişi için `Result.H5Link` bağlantısını açın.
2. H5 dilini seçmek için `H5Link` bağlantısına `lng` ekleyin; örneğin `&lng=en`. Dil, istek gövdesi alanı değildir.
3. H5 akışı tamamlandığında tarayıcı `Result.CallbackURL` adresini açar. Callback sorgusu `bytedToken`, `resultCode`, `algorithmBaseRespCode`, `reqMeasureInfoValue` ve `verify_type` içerebilir.
4. `Result.GroupId` dönene kadar kaydedilen `BytedToken` ile [Görsel doğrulama sonucunu al](/tr/api-reference/video/get-visual-validation-result) çağrısını tekrarlayın.

`BytedToken` 30 dakika geçerlidir ve kimliği doğrulanmış kuruluş ile `ProjectName` değerine bağlıdır. H5 bağlantısı tamamlanmış tek bir doğrulamayı destekler ve kullanımdan sonra geçersiz olur.

`Result.H5Link` değerini opak bir tarayıcı URL'si olarak ele alın: üst düzey sayfa olarak açın; ayrıştırmayın, kodunu çözmeyin, yeniden yazmayın veya gömmeyin. Tarayıcı aktarımını ve callback köprüsünü TokenLab yönetir.

## Örnek İstek

```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"}'
```

## Örnek Yanıt

```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"
  }
}
```

Hatalar aynı üst düzey yapıyı kullanır. TokenLab’in diğer `/v1` API hata alanları yerine `ResponseMetadata.Error.Code` ve `ResponseMetadata.Error.Message` değerlerini okuyun.