Video & Materialien

Material-Asset-Gruppen auflisten

Listet Seedance-Materialgruppen auf, die der aktuellen Organisation gehören.

GET
/v1/videos/assets/groups

Listet Materialgruppen auf, die der authentifizierten Organisation gehören. Filtern Sie nach library_type und status, um Gruppen für virtuelle Avatare von Gruppen für echte Personen zu trennen.

Verwenden Sie eine zurückgegebene id beim Hochladen von Materialien. Übergeben Sie keine group_id als material_asset_id während der Videogenerierung; die Generierung erfordert eine id des Material-Assets.

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?library_type=aigc_avatar&page_size=20&project_name=default" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

Beispielantwort

{
  "groups": [
    {
      "id": "group-20260720123456-vrt01",
      "object": "seedance.material_asset_group",
      "project_name": "default",
      "library_type": "aigc_avatar",
      "group_name": "Product references",
      "status": "ACTIVE",
      "created_at": 1782998400000
    }
  ],
  "next_page_token": null
}
curl -X GET "https://example.com/v1/videos/assets/groups"
{  "groups": [    {      "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    },    {      "id": "group-20260720123456-real1",      "object": "seedance.material_asset_group",      "library_type": "liveness_face",      "group_name": "Creator A",      "description": null,      "status": "ACTIVE",      "metadata": null,      "created_at": 1782998400000    }  ],  "next_page_token": null}

Autorisierung

BearerAuth
AuthorizationBearer <token>

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

Ort: header

Abfrageparameter

page_size?integer
Bereich1 <= value <= 100
Standard20
page_token?string
status?string

Zulässige Werte

  • "ACTIVE"
  • "DELETED"
library_type?string

Nach TokenLab-Materialbibliotheksklasse filtern.

Zulässige Werte

  • "aigc_avatar"
  • "liveness_face"
project_name?string

Projektbereich für die Materialressource.

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

Antwort

application/json

application/json

application/json

application/json