Video ve materyaller

Görsel Doğrulama Oturumu Oluştur

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

POST
/api/v3

Yeniden kullanılabilir liveness_face materyallerini yüklemeden önce gerçek kişi görsel doğrulama oturumunu oluşturun. TokenLab, Volc Action API yapısını ve TokenLab Bearer kimlik doğrulamasını kullanır.

Oturumu oluşturanla aynı kimliği doğrulanmış organizasyonu, kullanıcıyı ve büyük/küçük harfe duyarlı ProjectName değerini kullanın.

Oturumu oluşturduktan hemen sonra Result.H5Link bağlantısını açın. İlk başlatma süresi 30 dakikalık BytedToken süresinden önce dolabilir; bu yüzden açmakta gecikmeyin.

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 imzalaması 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 olarak default değerini alır.

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 sonuna lng parametresini ekleyin, örneğin &lng=en. Dil, istek gövdesi alanı değildir.
  3. H5 akışı bittikten sonra tarayıcı Result.CallbackURL adresini açar. Geri arama 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 uç noktasını sorgulayın (poll).

BytedToken 30 dakika boyunca geçerlidir ve kimliği doğrulanmış organizasyon ile ProjectName ile sınırlandırılmıştır. H5 bağlantısı bir adet tamamlanmış kimlik doğrulamasını destekler ve kullanıldıktan sonra geçersiz hale gelir.

Result.H5Link bağlantısını opak bir tarayıcı URL'si olarak değerlendirin: üst düzey bir sayfa olarak açın ve ayrıştırmayın, kodunu çözmeyin, yeniden yazmayın veya gömmeyin. TokenLab, tarayıcı devrini ve geri arama köprüsünü yönetir.

İstek Örneği

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

Yanıt Örneği

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

Güvenli Yeniden Deneme

Kaybolan bir yanıtın kurtarılabilmesi için isteğe bağlı bir Idempotency-Key başlığı (1–255 karakter) gönderin. Aynı anahtar, API anahtarı, CallbackURL ve ProjectName ile yapılan bir yeniden deneme, aynı BytedToken ve H5Link değerlerini döndürür. Farklı bir istekle aynı anahtarın kullanılması 409 IdempotencyConflict hatası döndürür. İlk istek hala oluşturuluyorken, yanıt Retry-After: 2 başlığı ile birlikte 409 RequestInProgress olur. Geçersiz bir anahtar 400 InvalidParameter hatası döndürür.

Hatalar

Hatalar aynı üst düzey zarfı kullanır. TokenLab'in diğer /v1 API'lerindeki alanları beklemek yerine ResponseMetadata.Error.Code ve ResponseMetadata.Error.Message alanlarını okuyun.

DurumKodNeden
400InvalidParameterEksik veya geçersiz CallbackURL (kimlik bilgisi içermeyen herkese açık bir HTTPS URL'si olmalıdır), geçersiz Idempotency-Key veya bilinmeyen bir alan
400InvalidVersionVersion değeri 2024-01-01 değil
405MethodNotAllowedEylem yalnızca POST kabul eder
409IdempotencyConflict, RequestInProgressGüvenli Yeniden Deneme bölümüne bakın
503ServiceUnavailableGerçek kişi doğrulaması bu hesap için kullanılamıyor veya başarısız oldu; daha sonra tekrar deneyin
curl -X POST "https://example.com/api/v3" \  -H "Content-Type: application/json" \  -d '{    "CallbackURL": "http://example.com"  }'
{  "id": "string"}

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

Sorgu parametreleri

Action?string

Geçerli değerler

  • "CreateContentsGenerationsTasks"
  • "GetContentsGenerationsTask"
  • "ListContentsGenerationsTasks"
  • "DeleteContentsGenerationsTasks"
  • "CreateVisualValidateSession"
  • "GetVisualValidateResult"
  • "CreateAssetGroup"
  • "ListAssetGroups"
  • "GetAssetGroup"
  • "UpdateAssetGroup"
  • "DeleteAssetGroup"
  • "CreateAsset"
  • "ListAssets"
  • "GetAsset"
  • "UpdateAsset"
  • "DeleteAsset"
Version?string
varsayılan"2024-01-01"

Başlıklar

X-TokenLab-Delivery-Policy?string

İstek bazlı Teslimat politikası. API anahtarı ve Çalışma Alanı varsayılanlarını geçersiz kılar. Otomatik olarak önce TokenLab Verified dener ve çıktı, istek kabulü veya kalıcı kaynak oluşturma öncesinde bir kez Official seçeneğine geçiş yapabilir.

Geçerli değerler

  • "auto"
  • "verified"
  • "official"

İstek gövdesi

application/json

Yanıt

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json