Membuat sesi validasi visual

Buat sesi validasi visual sebelum mengunggah material liveness_face yang dapat digunakan kembali. TokenLab menggunakan format Action API Volc dan autentikasi Bearer TokenLab.

Endpoint dan autentikasi

POST https://api.tokenlab.sh/api/v3?Action=CreateVisualValidateSession&Version=2024-01-01
Authorization: Bearer <TOKENLAB_API_KEY>
Content-Type: application/json

Tanda tangan AK/SK Volc tidak diterima. CallbackURL wajib diisi dan harus berupa URL HTTPS publik. ProjectName bersifat opsional dengan nilai default default.

Alur

Simpan Result.BytedToken dan buka Result.H5Link untuk orang yang akan diverifikasi.
Untuk memilih bahasa H5, tambahkan lng ke H5Link, misalnya &lng=en. Bahasa bukan kolom dalam isi permintaan.
Setelah alur H5 selesai, browser membuka Result.CallbackURL. Kueri callback dapat memuat bytedToken, resultCode, algorithmBaseRespCode, reqMeasureInfoValue, dan verify_type.
Lakukan polling Mendapatkan hasil validasi visual dengan BytedToken yang disimpan hingga Result.GroupId dikembalikan.

BytedToken berlaku selama 30 menit dan terikat pada organisasi terautentikasi serta ProjectName. Tautan H5 hanya mendukung satu verifikasi yang selesai dan menjadi tidak valid setelah digunakan. Perlakukan Result.H5Link sebagai URL browser yang opak: buka sebagai halaman tingkat atas, dan jangan mengurai, mendekode, menulis ulang, atau menyematkannya. TokenLab mengelola handoff browser dan jembatan callback.

Contoh Permintaan

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 Respons

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

Kesalahan menggunakan struktur tingkat atas yang sama. Baca ResponseMetadata.Error.Code dan ResponseMetadata.Error.Message, bukan kolom kesalahan API /v1 TokenLab lainnya.

Dapatkan Status Video Mendapatkan hasil validasi visual

Inti

Teks

Berkas & batch

Gambar

Audio & realtime

Musik

Video & materi

Worlds

3D

Pekerjaan asinkron

Gemini native

Manajemen

Membuat sesi validasi visual

Endpoint dan autentikasi

Alur

Contoh Permintaan

Contoh Respons

​Endpoint dan autentikasi

​Alur

​Contoh Permintaan

​Contoh Respons

Endpoint dan autentikasi

Alur

Contoh Permintaan

Contoh Respons