Video & Materialien
Material-Asset-Gruppen auflisten
Listet Seedance-Materialgruppen auf, die der aktuellen Organisation gehören.
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 reale Personen zu trennen.
status akzeptiert ACTIVE oder DELETED. page_size akzeptiert Werte von 1–100 (Standardwert 20); übergeben Sie next_page_token aus einer Antwort als page_token, um die nächste Seite zu lesen.
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 grenzt Ressourcen innerhalb Ihrer Organisation ein und ist standardmäßig auf default gesetzt. Verwenden Sie denselben, zwischen Groß- und Kleinschreibung unterscheidenden Wert für zugehö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?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,
"updated_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 API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.
Ort: header
Abfrageparameter
1 <= value <= 10020Zulässige Werte
- "ACTIVE"
- "DELETED"
Nach TokenLab-Materialbibliotheksklasse filtern.
Zulässige Werte
- "aigc_avatar"
- "liveness_face"
Projektbereich für die Materialressource.
1 <= length <= 128"default"Antwort
application/json
application/json
application/json
application/json