Video & materi

Mendapatkan Grup Aset Material

Mengambil satu grup material Seedance berdasarkan ID grup TokenLab.

GET
/v1/videos/assets/groups/{groupId}

Mengambil satu grup material. library_type memberi tahu Anda apakah grup tersebut merupakan grup avatar virtual atau grup orang asli.

Gunakan endpoint ini sebelum mengunggah jika Anda perlu mengonfirmasi bahwa grup tersebut masih ada dan memiliki status: "ACTIVE".

project_name mencakup sumber daya di dalam organisasi Anda dan secara default bernilai default. Gunakan nilai yang sama (peka huruf besar-kecil) untuk grup dan aset terkait. Kirimkan dalam body JSON untuk POST/PUT dan dalam query string untuk GET/DELETE.

Contoh Permintaan

curl "https://api.tokenlab.sh/v1/videos/assets/groups/group-20260720123456-vrt01?project_name=default" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

Contoh Respons

{
  "id": "group-20260720123456-vrt01",
  "object": "seedance.material_asset_group",
  "project_name": "default",
  "library_type": "aigc_avatar",
  "group_name": "Product references",
  "description": "Reusable product shots",
  "status": "ACTIVE",
  "metadata": null,
  "created_at": 1782998400000,
  "updated_at": 1782998400000
}
curl -X GET "https://example.com/v1/videos/assets/groups/group-20260720123456-vrt01"
{  "id": "group-20260720123456-vrt01",  "object": "seedance.material_asset_group",  "library_type": "aigc_avatar",  "group_name": "Product references",  "description": "Foto produk yang dapat digunakan kembali",  "status": "ACTIVE",  "metadata": null,  "created_at": 1782998400000}

Otorisasi

BearerAuth
AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Parameter path

groupId*string

Parameter query

project_name?string

Cakupan proyek untuk sumber daya materi.

Panjang1 <= length <= 128
bawaan"default"

Respons

application/json

application/json

application/json

application/json

application/json