Video & Materialien

Material-Asset-Gruppe abrufen

Ruft eine Seedance-Materialgruppe anhand der TokenLab-Gruppen-ID ab.

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

Ruft eine Materialgruppe ab. Der library_type gibt an, ob es sich bei der Gruppe um eine Virtual-Avatar-Gruppe oder eine Real-Person-Gruppe handelt.

Verwenden Sie diesen Endpunkt vor dem Hochladen, wenn Sie bestätigen müssen, dass die Gruppe noch existiert und den status: "ACTIVE" aufweist.

project_name trennt Ressourcen innerhalb der authentifizierten Organisation. Der Standard ist default; verwenden Sie für zugehörige Gruppen und Assets denselben Wert mit gleicher Groß- und Kleinschreibung. Senden Sie ihn bei POST/PUT im JSON-Body und bei GET/DELETE als Query-Parameter.

Beispielanfrage

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

Beispielantwort

{
  "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": "Wiederverwendbare Produktaufnahmen",  "status": "ACTIVE",  "metadata": null,  "created_at": 1782998400000}

Autorisierung

BearerAuth
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Pfadparameter

groupId*string

Abfrageparameter

project_name?string

Projektbereich für die Materialressource.

Länge1 <= length <= 128
Standard"default"

Antwort

application/json

application/json

application/json

application/json

application/json