Görsel doğrulama oturumu oluştur

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

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ış

Result.BytedToken değerini kaydedin ve doğrulanacak kişi için Result.H5Link bağlantısını açın.
H5 dilini seçmek için H5Link bağlantısına lng ekleyin; örneğin &lng=en. Dil, istek gövdesi alanı değildir.
H5 akışı tamamlandığında tarayıcı Result.CallbackURL adresini açar. Callback sorgusu bytedToken, resultCode, algorithmBaseRespCode, reqMeasureInfoValue ve verify_type içerebilir.
Result.GroupId dönene kadar kaydedilen BytedToken ile Görsel doğrulama sonucunu al ç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

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

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

Video Durumunu Al Görsel doğrulama sonucunu al

Temel

Metin

Dosyalar ve toplu işler

Görseller

Ses ve gerçek zamanlı

Müzik

Video ve materyaller

Worlds

3D

Asenkron işler

Gemini yerel

Yönetim

Görsel doğrulama oturumu oluştur

Uç nokta ve kimlik doğrulama

Akış

Örnek İstek

Örnek Yanıt

​Uç nokta ve kimlik doğrulama

​Akış

​Örnek İstek

​Örnek Yanıt

Uç nokta ve kimlik doğrulama

Akış

Örnek İstek

Örnek Yanıt