TokenLab
الحصول على مفتاح API
التوثيقمرجع APIالتكاملات

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

سرد مجموعات أصول المواد

سرد مجموعات مواد Seedance المملوكة للمؤسسة الحالية.

GET
/v1/videos/assets/groups

سرد مجموعات المواد المملوكة للمؤسسة التي تم التحقق من هويتها. قم بالتصفية حسب library_type و status للفصل بين مجموعات الصور الرمزية الافتراضية (virtual-avatar) ومجموعات الأشخاص الحقيقيين.

استخدم id المُعاد عند تحميل المواد. لا تقم بتمرير group_id كـ material_asset_id أثناء إنشاء الفيديو؛ حيث يتطلب الإنشاء id خاص بأصل المادة.

يعزل project_name الموارد داخل المؤسسة المصادق عليها. قيمته الافتراضية default؛ استخدم القيمة نفسها مع مراعاة حالة الأحرف للمجموعات والأصول المرتبطة. أرسله في جسم JSON مع POST/PUT وفي معاملات الاستعلام مع GET/DELETE.

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

curl "https://api.tokenlab.sh/v1/videos/assets/groups?library_type=aigc_avatar&page_size=20&project_name=default" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

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

{
  "groups": [
    {
      "id": "group-20260720123456-vrt01",
      "object": "seedance.material_asset_group",
      "project_name": "default",
      "library_type": "aigc_avatar",
      "group_name": "Product references",
      "status": "ACTIVE",
      "created_at": 1782998400000
    }
  ],
  "next_page_token": null
}
curl -X GET "https://example.com/v1/videos/assets/groups"
{  "groups": [    {      "id": "group-20260720123456-vrt01",      "object": "seedance.material_asset_group",      "library_type": "aigc_avatar",      "group_name": "Product references",      "description": "لقطات منتجات قابلة لإعادة الاستخدام",      "status": "ACTIVE",      "metadata": null,      "created_at": 1782998400000    },    {      "id": "group-20260720123456-real1",      "object": "seedance.material_asset_group",      "library_type": "liveness_face",      "group_name": "Creator A",      "description": null,      "status": "ACTIVE",      "metadata": null,      "created_at": 1782998400000    }  ],  "next_page_token": null}

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

معاملات الاستعلام

page_size?integer
النطاق1 <= value <= 100
الافتراضي20
page_token?string
status?string

القيم المتاحة

  • "ACTIVE"
  • "DELETED"
library_type?string

التصفية حسب فئة مكتبة مواد TokenLab.

القيم المتاحة

  • "aigc_avatar"
  • "liveness_face"
project_name?string

نطاق المشروع لمورد المادة.

الطول1 <= length <= 128
الافتراضي"default"

الاستجابة

application/json

application/json

application/json

application/json

إنشاء مجموعة أصول المواد

السابق

الحصول على مجموعة أصول المواد

التالي