Vídeo e materiais
Listar Grupos de Ativos de Material
Lista grupos de material Seedance pertencentes à organização atual.
Liste os grupos de material pertencentes à organização autenticada. Filtre por library_type e status para separar grupos de avatares virtuais de grupos de pessoas reais.
status aceita ACTIVE ou DELETED. page_size aceita de 1 a 100 (padrão 20); passe o next_page_token de uma resposta como page_token para ler a próxima página.
Use um id retornado ao fazer upload de materiais. Não passe um group_id como material_asset_id durante a geração de vídeo; a geração requer um id de ativo de material.
project_name delimita recursos dentro da sua organização e tem como padrão default. Use o mesmo valor, respeitando maiúsculas e minúsculas, para grupos e ativos relacionados. Envie-o no corpo JSON para POST/PUT e na query string para GET/DELETE.
Exemplo de Requisição
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"Exemplo de Resposta
{
"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": "Fotos de produto reutilizáveis", "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}Autorização
BearerAuth Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.
Local: header
Parâmetros de consulta
1 <= value <= 10020Valores permitidos
- "ACTIVE"
- "DELETED"
Filtrar por classe de biblioteca de materiais do TokenLab.
Valores permitidos
- "aigc_avatar"
- "liveness_face"
Escopo do projeto para o recurso de material.
1 <= length <= 128"default"Resposta
application/json
application/json
application/json
application/json