إجراءات المواد المتوافقة مع Volcengine

تدعم نقاط النهاية هذه إجراءات المواد والحقول المذكورة أدناه، باستخدام مصادقة Bearer من TokenLab وغلاف ResponseMetadata + Result.

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

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

يدعم أيضًا POST /api/v3?Action=<ACTION>&Version=2024-01-01. جميع إجراءات المواد تقبل POST فقط. يعيد الطلب الذي يحتوي على توقيع AK/SK فقط الخطأ 401 InvalidCredential.

القيمة الافتراضية لـ ProjectName هي default وهي حد عزل فعلي داخل المؤسسة المصادق عليها. استخدم القيمة نفسها في الطلبات المرتبطة.

إجراءات مجموعات الموادCopy Anchor Link

ينشئ CreateAssetGroup مجموعات AIGC فقط. تنشأ مجموعة LivenessFace بعد نجاح التحقق من الشخص، ويمكن لـ ListAssetGroups تصفية النوعين.

إنشاء مجموعةCopy Anchor Link

curl 'https://api.tokenlab.sh/?Action=CreateAssetGroup&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"Name":"Product references","Description":"Reusable product shots","GroupType":"AIGC","ProjectName":"default"}'

{
  "ResponseMetadata": {
    "RequestId": "req-id",
    "Action": "CreateAssetGroup",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {"Id":"group-20260720123456-abc12"}
}

إجراءات الموادCopy Anchor Link

يقبل AssetType القيم Image وVideo وAudio. تحدد المجموعة الهدف ما إذا كانت المادة AIGC عادية أم LivenessFace موثقة.

استخدم معرفات مواد TokenLab. يعيد CreateAsset الحقل Result.Id قبل اكتمال المعالجة؛ استعلم عن GetAsset حتى تصبح Result.Status إما Active أو Failed. يدعم ListAssets أيضًا SortBy: "GroupId".

إنشاء مادةCopy Anchor Link

curl 'https://api.tokenlab.sh/?Action=CreateAsset&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"GroupId":"group-20260720123456-abc12","URL":"https://example.com/reference.png","Name":"Front view","AssetType":"Image","ProjectName":"default"}'

سلوك القوائمCopy Anchor Link

القيمة الافتراضية لـ PageNumber هي 1 ولـ PageSize هي 10 والحد الأقصى 100. يقبل SortBy القيمة CreateTime أو UpdateTime، ويقبل SortOrder القيمة Desc أو Asc.

حالات المادة هي Active وProcessing وFailed. الروابط المؤقتة من GetAsset وListAssets صالحة 12 ساعة. احفظ Id كهوية دائمة.

يعيد ListAssetGroups وListAssets الموارد داخل Result.Items مع TotalCount وPageNumber وPageSize.

{
  "ResponseMetadata": {
    "RequestId": "req-id",
    "Action": "ListAssets",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {"Items":[],"TotalCount":0,"PageNumber":1,"PageSize":10}
}

مواد الأشخاص الحقيقيينCopy Anchor Link

أنشئ جلسة تحقق مرئي وأكمل تحقق H5، ثم احصل على GroupId واستخدم المجموعة مع CreateAsset. تتم مقارنة الملفات المرفوعة بالوجه الموثق.

1. إنشاء جلسة تحقق مرئي
2. جلب نتيجة التحقق المرئي
3. استدعاء CreateAsset باستخدام GroupId المعاد

الأخطاءCopy Anchor Link

تحافظ الأخطاء على غلاف استجابة Volcengine، ويوجد الرمز والرسالة تحت ResponseMetadata.Error.

{
  "ResponseMetadata": {
    "RequestId": "req-id",
    "Action": "CreateAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing",
    "Error": {"Code":"InvalidParameter","Message":"GroupId is required"}
  }
}

InvalidCredential, InvalidVersion, InvalidParameter, NotFound, Conflict, OperationDenied, MethodNotAllowed, InternalError.

بديل RESTCopy Anchor Link

تبقى واجهات REST على /v1/videos/assets* متاحة. يمكن للتكاملات الجديدة اختيار REST بصيغة snake_case، ولا يحتاج عملاء Volcengine إلى إعادة تشكيل الأجسام. مواد Seedance والتحقق من الأشخاص.

curl -X POST "https://example.com/api/v3" \  -H "Content-Type: application/json" \  -d '{    "CallbackURL": "http://example.com"  }'

{  "id": "string"}