Vídeo e materiais

Criar Grupo de Ativos de Material

Cria um grupo de material de avatar virtual Seedance.

POST
/v1/videos/assets/groups

Crie um grupo de material library_type: "aigc_avatar" para avatares virtuais, produtos, estilos e outras referências reutilizáveis que não exigem verificação de pessoa real. group_name é opcional (1–128 caracteres) e description é opcional (até 500 caracteres). Uma solicitação bem-sucedida retorna 201.

Grupos de pessoas reais não podem ser criados com este endpoint; library_type: "liveness_face" retorna 400. Crie-os através da validação visual.

project_name delimita recursos dentro da sua organização e tem como padrão default. Use o mesmo valor (diferenciando maiúsculas de minúsculas) para grupos e ativos relacionados. Envie-o no corpo JSON para POST/PUT e na query string para GET/DELETE.

Exemplo de Solicitação

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

Exemplo de Resposta

{
  "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": "Fotos de produto reutilizáveis"  }'
{  "id": "group-20260720123456-vrt01",  "object": "seedance.material_asset_group",  "library_type": "aigc_avatar",  "group_name": "Product references",  "description": "Fotos de produto reutilizáveis",  "status": "ACTIVE",  "metadata": null,  "created_at": 1782998400000}

Autorização

BearerAuth
AuthorizationBearer <token>

Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.

Local: header

Corpo da requisição

application/json

Resposta

application/json

application/json

application/json

application/json

application/json

application/json