Video & materi
Membuat Sesi Validasi Visual
Membuat sesi validasi visual orang asli yang kompatibel dengan Volc.
Buat sesi validasi visual orang asli sebelum mengunggah materi liveness_face yang dapat digunakan kembali. TokenLab menggunakan bentuk Volc Action API dan autentikasi Bearer TokenLab.
Gunakan organisasi, pengguna, dan ProjectName peka huruf besar-kecil (case-sensitive) yang terautentikasi sama yang membuat sesi tersebut.
Buka Result.H5Link segera setelah membuat sesi. Peluncuran awalnya dapat kedaluwarsa sebelum BytedToken 30 menit; jangan menunda untuk membukanya.
Endpoint Dan Autentikasi
POST https://api.tokenlab.sh/api/v3?Action=CreateVisualValidateSession&Version=2024-01-01
Authorization: Bearer <TOKENLAB_API_KEY>
Content-Type: application/jsonPenandatanganan Volc AK/SK tidak diterima. CallbackURL wajib diisi dan harus berupa URL HTTPS publik. ProjectName bersifat opsional dan secara default bernilai default.
Alur
- Simpan
Result.BytedTokendan bukaResult.H5Linkuntuk orang yang diverifikasi. - Untuk memilih bahasa H5, tambahkan
lngkeH5Link, contohnya&lng=en. Bahasa bukan merupakan field request-body. - Setelah alur H5 selesai, browser akan membuka
Result.CallbackURL. Query callback dapat berisibytedToken,resultCode,algorithmBaseRespCode,reqMeasureInfoValue, danverify_type. - Lakukan polling Mendapatkan hasil validasi visual dengan
BytedTokenyang disimpan hinggaResult.GroupIddikembalikan.
BytedToken berlaku selama 30 menit dan dicakup untuk organisasi serta ProjectName yang terautentikasi. Tautan H5 mendukung satu autentikasi yang berhasil dan menjadi tidak valid setelah digunakan.
Perlakukan Result.H5Link sebagai URL browser yang buram (opaque): buka sebagai halaman tingkat atas, dan jangan mengurai, mendekode, menulis ulang, atau menyematkannya. TokenLab memiliki kendali atas serah terima browser dan jembatan callback.
Contoh Request
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"}'Contoh Response
{
"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"
}
}Percobaan Ulang yang Aman
Kirim header Idempotency-Key opsional (1–255 karakter) agar respons yang hilang dapat dipulihkan. Percobaan ulang dengan kunci, API key, CallbackURL, dan ProjectName yang sama akan mengembalikan BytedToken dan H5Link yang sama. Kunci yang sama dengan request berbeda akan mengembalikan 409 IdempotencyConflict. Saat request pertama masih dalam proses pembuatan, responsnya adalah 409 RequestInProgress dengan Retry-After: 2. Kunci yang tidak valid akan mengembalikan 400 InvalidParameter.
Error
Error menggunakan amplop tingkat atas yang sama. Baca ResponseMetadata.Error.Code dan ResponseMetadata.Error.Message alih-alih mengharapkan field dari API /v1 TokenLab lainnya.
| Status | Kode | Penyebab |
|---|---|---|
400 | InvalidParameter | CallbackURL hilang atau tidak valid (harus berupa URL HTTPS publik tanpa kredensial), Idempotency-Key tidak valid, atau field tidak dikenal |
400 | InvalidVersion | Version bukan 2024-01-01 |
405 | MethodNotAllowed | Action hanya menerima POST |
409 | IdempotencyConflict, RequestInProgress | Lihat Percobaan Ulang yang Aman |
503 | ServiceUnavailable | Validasi orang asli tidak tersedia untuk akun ini atau gagal; coba lagi nanti |
curl -X POST "https://example.com/api/v3" \ -H "Content-Type: application/json" \ -d '{ "CallbackURL": "http://example.com" }'{ "id": "string"}Otorisasi
BearerAuth Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Lokasi: header
Parameter query
Nilai yang tersedia
- "CreateContentsGenerationsTasks"
- "GetContentsGenerationsTask"
- "ListContentsGenerationsTasks"
- "DeleteContentsGenerationsTasks"
- "CreateVisualValidateSession"
- "GetVisualValidateResult"
- "CreateAssetGroup"
- "ListAssetGroups"
- "GetAssetGroup"
- "UpdateAssetGroup"
- "DeleteAssetGroup"
- "CreateAsset"
- "ListAssets"
- "GetAsset"
- "UpdateAsset"
- "DeleteAsset"
"2024-01-01"Header
Kebijakan Pengiriman per-permintaan. Menggantikan default API key dan Workspace. Secara otomatis mencoba TokenLab Verified terlebih dahulu dan dapat beralih satu kali ke Official saja sebelum output, penerimaan permintaan, atau pembuatan sumber daya persisten.
Nilai yang tersedia
- "auto"
- "verified"
- "official"
Body permintaan
application/json
Respons
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json