Video y recursos

Crear grupo de activos de material

Crea un grupo de material de avatar virtual de Seedance.

POST
/v1/videos/assets/groups

Cree un grupo de material library_type: "aigc_avatar" para avatares virtuales, productos, estilos y otras referencias reutilizables que no requieran verificación de persona real. group_name es opcional (1–128 caracteres) y description es opcional (hasta 500 caracteres). Una solicitud exitosa devuelve 201.

Los grupos de personas reales no pueden crearse con este endpoint; library_type: "liveness_face" devuelve 400. Créelos a través de la validación visual.

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 \
  -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"}'

Ejemplo de respuesta

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

Autorización

BearerAuth
AuthorizationBearer <token>

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

Ubicación: header

Cuerpo de la solicitud

application/json

Respuesta

application/json

application/json

application/json

application/json

application/json

application/json