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 melakukan pengunggahan jika Anda perlu memastikan bahwa grup tersebut masih ada dan memiliki status: "ACTIVE".

project_name memisahkan sumber daya dalam organisasi yang terautentikasi. Nilai default adalah default; gunakan nilai yang sama dan peka huruf besar-kecil untuk grup dan aset terkait. Kirim di body JSON untuk POST/PUT dan parameter kueri 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
}
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