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

سرد أصول المواد (List Material Assets)

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

GET
/v1/videos/assets

قم بسرد المواد في مؤسستك ومشروعك. يمكنك التصفية حسب library_type أو group_id أو status (PROCESSING، ACTIVE، FAILED، DELETED). تقبل page_size قيمة من 1 إلى 100 (القيمة الافتراضية هي 20). قم بتمرير next_page_token من الاستجابة كـ page_token لقراءة الصفحة التالية.

استخدم فقط الأصول التي تكون حالتها status هي ACTIVE. استخدم id الخاص بأصل مادة TokenLab الذي تم إرجاعه عند إنشاء مقاطع الفيديو.

يحدد project_name نطاق الموارد داخل مؤسستك، والقيمة الافتراضية له هي default. استخدم نفس القيمة الحساسة لحالة الأحرف للمجموعات والأصول ذات الصلة. أرسلها في نص JSON لطلبات POST/PUT وفي سلسلة الاستعلام (query string) لطلبات GET/DELETE.

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

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

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

{
  "assets": [
    {
      "id": "asset-20260720123456-qn7wr",
      "object": "seedance.material_asset",
      "project_name": "default",
      "group_id": "group-20260720123456-vrt01",
      "library_type": "aigc_avatar",
      "asset_name": "Front view",
      "asset_type": "Image",
      "status": "ACTIVE",
      "ready": true,
      "created_at": 1782998400000,
      "updated_at": 1782998400000
    }
  ],
  "next_page_token": null
}
curl -X GET "https://example.com/v1/videos/assets"
{  "assets": [    {      "id": "asset-20260720123456-qn7wr",      "object": "seedance.material_asset",      "group_id": "group-20260720123456-vrt01",      "library_type": "aigc_avatar",      "asset_name": "Front view",      "asset_type": "Image",      "status": "ACTIVE",      "ready": true,      "error_message": null,      "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
group_id?string

التصفية حسب معرف مجموعة أصول مواد TokenLab.

status?string

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

  • "PROCESSING"
  • "ACTIVE"
  • "FAILED"
  • "DELETED"
library_type?string

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

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

  • "aigc_avatar"
  • "liveness_face"
project_name?string

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

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

الاستجابة

application/json

application/json

application/json

application/json