إنشاء جلسة تحقق مرئي

أنشئ جلسة تحقق مرئي قبل رفع مواد liveness_face القابلة لإعادة الاستخدام. يستخدم TokenLab تنسيق Action API من Volc ومصادقة Bearer الخاصة بـ TokenLab.

نقطة النهاية والمصادقة

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

لا تُقبل توقيعات AK/SK من Volc. الحقل CallbackURL مطلوب ويجب أن يكون عنوان HTTPS عامًا. الحقل ProjectName اختياري وقيمته الافتراضية default.

التدفق

احفظ Result.BytedToken وافتح Result.H5Link للشخص المراد التحقق منه.
لاختيار لغة H5، أضف lng إلى H5Link، مثل &lng=en. اللغة ليست حقلاً في نص الطلب.
بعد اكتمال تدفق H5، يفتح المتصفح Result.CallbackURL. قد يتضمن استعلام callback القيم bytedToken وresultCode وalgorithmBaseRespCode وreqMeasureInfoValue وverify_type.
استعلم دوريًا عن الحصول على نتيجة التحقق المرئي باستخدام BytedToken المحفوظ حتى تُعاد Result.GroupId.

تظل BytedToken صالحة لمدة 30 دقيقة وترتبط بالمؤسسة المصادق عليها وبـ ProjectName. يسمح رابط H5 بإكمال تحقق واحد فقط ويصبح غير صالح بعد الاستخدام. تعامل مع Result.H5Link كعنوان متصفح غير شفاف: افتحه كصفحة من المستوى الأعلى، ولا تحلله أو تفك ترميزه أو تعيد كتابته أو تضمّنه. تتولى TokenLab تسليم المتصفح وجسر callback.

مثال على الطلب

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

مثال على الاستجابة

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

تستخدم الأخطاء البنية العليا نفسها. اقرأ ResponseMetadata.Error.Code وResponseMetadata.Error.Message بدل توقع حقول الأخطاء في واجهات TokenLab الأخرى ضمن /v1.

الحصول على حالة الفيديو الحصول على نتيجة التحقق المرئي

الأساسيات

النص

الملفات والدفعات

الصور

الصوت والوقت الفعلي

الموسيقى

الفيديو والمواد

Worlds

3D

المهام غير المتزامنة

Gemini الأصلي

الإدارة

إنشاء جلسة تحقق مرئي

نقطة النهاية والمصادقة

التدفق

مثال على الطلب

مثال على الاستجابة

​نقطة النهاية والمصادقة

​التدفق

​مثال على الطلب

​مثال على الاستجابة

نقطة النهاية والمصادقة

التدفق

مثال على الطلب

مثال على الاستجابة