Vídeo e materiais

Obter Grupo de Ativos de Material

Recupera um grupo de material Seedance pelo ID de grupo do TokenLab.

GET
/v1/videos/assets/groups/{groupId}

Recupere um grupo de material. O library_type informa se o grupo é um grupo de avatar virtual ou um grupo de pessoa real.

Use este endpoint antes de fazer o upload se precisar confirmar que o grupo ainda existe e possui status: "ACTIVE".

project_name isola recursos dentro da organização autenticada. O padrão é default; use o mesmo valor, diferenciando maiúsculas e minúsculas, para grupos e ativos relacionados. Envie-o no corpo JSON para POST/PUT e na consulta para GET/DELETE.

Exemplo de Requisição

curl "https://api.tokenlab.sh/v1/videos/assets/groups/group-20260720123456-vrt01?project_name=default" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

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
}
curl -X GET "https://example.com/v1/videos/assets/groups/group-20260720123456-vrt01"
{  "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

Parâmetros de caminho

groupId*string

Parâmetros de consulta

project_name?string

Escopo do projeto para o recurso de material.

Comprimento1 <= length <= 128
padrão"default"

Resposta

application/json

application/json

application/json

application/json

application/json