TokenLab

Vidéo & ressources

Lister les groupes d'actifs matériels

Liste les groupes de matériaux Seedance appartenant à l'organisation actuelle.

GET
/v1/videos/assets/groups

Liste les groupes de matériaux appartenant à l'organisation authentifiée. Filtrez par library_type et status pour séparer les groupes d'avatars virtuels des groupes de personnes réelles.

status accepte ACTIVE ou DELETED. page_size accepte une valeur de 1 à 100 (20 par défaut) ; transmettez le next_page_token d'une réponse en tant que page_token pour lire la page suivante.

Utilisez un id renvoyé lors du téléchargement de matériaux. Ne transmettez pas de group_id en tant que material_asset_id lors de la génération de vidéo ; la génération nécessite un id d'actif matériel.

project_name délimite les ressources au sein de votre organisation et est défini par défaut sur default. Utilisez la même valeur sensible à la casse pour les groupes et les actifs associés. Envoyez-le dans le corps JSON pour les requêtes POST/PUT et dans la chaîne de requête pour les requêtes GET/DELETE.

Exemple de requête

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"

Exemple de réponse

{
  "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": "Prises de vue de produits réutilisables",      "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}

Autorisation

BearerAuth
AuthorizationBearer <token>

Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.

Emplacement: header

Paramètres de requête

page_size?integer
Plage1 <= value <= 100
par défaut20
page_token?string
status?string

Valeurs possibles

  • "ACTIVE"
  • "DELETED"
library_type?string

Filtrer par classe de bibliothèque de matériaux TokenLab.

Valeurs possibles

  • "aigc_avatar"
  • "liveness_face"
project_name?string

Portée du projet pour la ressource matérielle.

Longueur1 <= length <= 128
par défaut"default"

Réponse

application/json

application/json

application/json

application/json