Vídeo e materiais
Criar Ativo de Material
Faz o upload de um ativo de material Seedance para um grupo de materiais TokenLab.
Importe uma URL de origem publicamente acessível para um grupo de materiais Seedance. O TokenLab armazena o material para uso posterior; utilize o id do ativo de material retornado para a geração, e não a URL de origem.
Para library_type: "aigc_avatar", o group_id é opcional; sem ele, o TokenLab utiliza ou cria o grupo de avatar virtual padrão da organização. Para library_type: "liveness_face", o group_id é obrigatório e deve ser o grupo TokenLab retornado por Obter Resultado de Validação Visual. O group_id também é obrigatório quando project_name não é default. O grupo deve pertencer ao mesmo project_name e library_type, caso contrário, a requisição retornará 400.
| Tipo | Entrada suportada |
|---|---|
| Imagem | jpeg, jpg, png, webp, bmp, tiff, gif, heic, heif; ≤30 MiB; largura e altura [300, 6000] px; proporção [0.4, 2.5]. |
| Vídeo | mp4, mov; ≤200 MiB. |
| Áudio | aac, wav, mp3; ≤15 MiB. |
O TokenLab verifica a URL de origem, o tipo de mídia, o tamanho do arquivo e, quando a imagem pode ser lida, suas dimensões antes de aceitar a requisição. Uma origem que falha nessas verificações retorna 400 com um código seedance_material_source_*, por exemplo, seedance_material_source_invalid (dimensões da imagem ou proporção fora do intervalo), seedance_material_source_type_mismatch, seedance_material_source_too_large ou seedance_material_source_url_unreachable. Outros requisitos de mídia e de face são avaliados durante o processamento, portanto, a aceitação não significa que o ativo está pronto: aguarde pelo status ACTIVE e inspecione a error_message caso o processamento falhe.
Uma requisição bem-sucedida retorna 201 com status: "PROCESSING". Realize o polling em Obter Ativo de Material até que o status seja ACTIVE. Para grupos de pessoas reais, um grupo mapeia para uma pessoa verificada; uploads com múltiplas faces ou uma face que não corresponda à pessoa verificada podem falhar.
project_name delimita recursos dentro da sua organização e tem como padrão default. Utilize o mesmo valor (sensível a 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 \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"library_type":"aigc_avatar","group_id":"group-20260720123456-vrt01","asset_url":"https://example.com/reference.png","asset_type":"Image","asset_name":"Front view","project_name":"default"}'Exemplo de Resposta
{
"id": "asset-20260720123456-qn7wr",
"object": "seedance.material_asset",
"project_name": "default",
"group_id": "group-20260720123456-vrt01",
"library_type": "aigc_avatar",
"asset_name": "Front view",
"asset_type": "Image",
"status": "PROCESSING",
"ready": false,
"error_message": null,
"metadata": null,
"created_at": 1782998400000,
"updated_at": 1782998400000
}curl -X POST "https://example.com/v1/videos/assets" \ -H "Content-Type: application/json" \ -d '{ "asset_url": "https://example.com/reference.png", "asset_name": "Front view", "asset_type": "Image", "library_type": "aigc_avatar", "group_id": "group-20260720123456-vrt01" }'{ "id": "asset-20260720123456-qn7wr", "object": "seedance.material_asset", "group_id": "group-20260720123456-vrt01", "library_type": "aigc_avatar", "asset_name": "Front view", "asset_type": "Image", "status": "PROCESSING", "ready": false, "error_message": null, "metadata": null, "created_at": 1782998400000}Autorização
BearerAuth 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