Video y recursos

Listar grupos de activos de material

Enumera los grupos de material de Seedance propiedad de la organización actual.

GET
/v1/videos/assets/groups

Enumera los grupos de material propiedad de la organización autenticada. Filtre por library_type y status para separar los grupos de avatares virtuales de los grupos de personas reales.

status acepta ACTIVE o DELETED. page_size acepta valores de 1 a 100 (el valor predeterminado es 20); pase el next_page_token de una respuesta como page_token para leer la página siguiente.

Utilice un id devuelto al cargar materiales. No pase un group_id como material_asset_id durante la generación de video; la generación requiere un id de activo de material.

project_name delimita los recursos dentro de su organización y tiene como valor predeterminado default. Utilice el mismo valor (sensible a mayúsculas y minúsculas) para grupos y activos relacionados. Envíelo en el cuerpo JSON para POST/PUT y en la cadena de consulta para GET/DELETE.

Ejemplo de solicitud

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"

Ejemplo de respuesta

{
  "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": "Tomas de producto reutilizables",      "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}

Autorización

BearerAuth
AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Parámetros de consulta

page_size?integer
Rango1 <= value <= 100
predeterminado20
page_token?string
status?string

Valores permitidos

  • "ACTIVE"
  • "DELETED"
library_type?string

Filtrar por clase de biblioteca de materiales de TokenLab.

Valores permitidos

  • "aigc_avatar"
  • "liveness_face"
project_name?string

Ámbito del proyecto para el recurso de material.

Longitud1 <= length <= 128
predeterminado"default"

Respuesta

application/json

application/json

application/json

application/json