Vídeo e materiais

Criar Ativo de Material

Faz o upload de um ativo de material Seedance para um grupo de materiais TokenLab.

POST
/v1/videos/assets

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.

TipoEntrada suportada
Imagemjpeg, jpg, png, webp, bmp, tiff, gif, heic, heif; ≤30 MiB; largura e altura [300, 6000] px; proporção [0.4, 2.5].
Vídeomp4, mov; ≤200 MiB.
Áudioaac, 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
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