Video & Materialien

Material-Asset-Gruppe erstellen

Erstellt eine Seedance Virtual-Avatar-Materialgruppe.

POST
/v1/videos/assets/groups

Erstellen Sie eine Materialgruppe vom Typ library_type: "aigc_avatar" für virtuelle Avatare, Produkte, Stile und andere wiederverwendbare Referenzen, die keine Verifizierung echter Personen erfordern. group_name ist optional (1–128 Zeichen) und description ist optional (bis zu 500 Zeichen). Eine erfolgreiche Anfrage gibt 201 zurück.

Gruppen für echte Personen können mit diesem Endpunkt nicht erstellt werden; library_type: "liveness_face" gibt 400 zurück. Erstellen Sie diese über die visuelle Validierung.

project_name grenzt Ressourcen innerhalb Ihrer Organisation ein und ist standardmäßig auf default gesetzt. Verwenden Sie denselben, zwischen Groß- und Kleinschreibung unterscheidenden Wert für zusammengehörige Gruppen und Assets. Senden Sie ihn im JSON-Body für POST/PUT und im Query-String für GET/DELETE.

Beispielanfrage

curl https://api.tokenlab.sh/v1/videos/assets/groups \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"library_type":"aigc_avatar","group_name":"Product references","description":"Reusable product shots","project_name":"default"}'

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,
  "updated_at": 1782998400000
}
curl -X POST "https://example.com/v1/videos/assets/groups" \  -H "Content-Type: application/json" \  -d '{    "library_type": "aigc_avatar",    "group_name": "Product references",    "description": "Wiederverwendbare Produktaufnahmen"  }'
{  "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

Anfragekörper

application/json

Antwort

application/json

application/json

application/json

application/json

application/json

application/json