Vídeo e materiais

Atualizar Material Asset

Atualiza um material asset do Seedance pertencente à organização atual.

PUT
/v1/videos/assets/{assetId}

Atualize asset_name ou metadata; envie pelo menos um deles. A URL de origem e o tipo de asset não podem ser alterados; crie um novo asset quando o arquivo de origem for alterado.

Apenas um asset com status ACTIVE pode ser atualizado: um asset PROCESSING retornará 409 com seedance_material_preparing, e um asset FAILED retornará 422.

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 assets 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/asset-20260720123456-qn7wr \
  -X PUT \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_name":"Front view approved","metadata":{"approved_by":"creative-team"},"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 approved",
  "asset_type": "Image",
  "status": "ACTIVE",
  "ready": true,
  "error_message": null,
  "metadata": {"approved_by": "creative-team"},
  "created_at": 1782998400000,
  "updated_at": 1782998400000
}
curl -X PUT "https://example.com/v1/videos/assets/asset-20260720123456-qn7wr" \  -H "Content-Type: application/json" \  -d '{    "asset_name": "Front view approved",    "metadata": {      "approved_by": "creative-team"    }  }'
{  "id": "asset-20260720123456-qn7wr",  "object": "seedance.material_asset",  "group_id": "group-20260720123456-vrt01",  "library_type": "aigc_avatar",  "asset_name": "Front view approved",  "asset_type": "Image",  "status": "ACTIVE",  "ready": true,  "error_message": null,  "metadata": {    "approved_by": "creative-team"  },  "created_at": 1782998400000}

Autorização

bearerAuth

Parâmetros de caminho

assetId*string

ID do ativo de material TokenLab.

Corpo da requisição

application/json

Atualize asset_name ou metadados. A URL de origem e o tipo de ativo não podem ser alterados; crie um novo ativo.

Propriedades1 <= properties

Resposta

application/json

application/json

application/json

application/json

application/json

application/json

application/json