Video ve materyaller
Görsel Doğrulama Oturumu Oluştur
Volc uyumlu bir gerçek kişi görsel doğrulama oturumu oluşturur.
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/jsonVolc 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ış
Result.BytedTokendeğerini kaydedin ve doğrulanacak kişi içinResult.H5Linkbağlantısını açın.- H5 dilini seçmek için
H5Linksonunalngparametresini ekleyin, örneğin&lng=en. Dil, istek gövdesi alanı değildir. - H5 akışı bittikten sonra tarayıcı
Result.CallbackURLadresini açar. Geri arama sorgusubytedToken,resultCode,algorithmBaseRespCode,reqMeasureInfoValueveverify_typeiçerebilir. Result.GroupIddönene kadar kaydedilenBytedTokenile 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.
| Durum | Kod | Neden |
|---|---|---|
400 | InvalidParameter | Eksik 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 |
400 | InvalidVersion | Version değeri 2024-01-01 değil |
405 | MethodNotAllowed | Eylem yalnızca POST kabul eder |
409 | IdempotencyConflict, RequestInProgress | Güvenli Yeniden Deneme bölümüne bakın |
503 | ServiceUnavailable | Gerç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 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
Geçerli değerler
- "CreateContentsGenerationsTasks"
- "GetContentsGenerationsTask"
- "ListContentsGenerationsTasks"
- "DeleteContentsGenerationsTasks"
- "CreateVisualValidateSession"
- "GetVisualValidateResult"
- "CreateAssetGroup"
- "ListAssetGroups"
- "GetAssetGroup"
- "UpdateAssetGroup"
- "DeleteAssetGroup"
- "CreateAsset"
- "ListAssets"
- "GetAsset"
- "UpdateAsset"
- "DeleteAsset"
"2024-01-01"Başlıklar
İ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