Video & Materialien

Material-Asset aktualisieren

Aktualisiert ein Seedance-Material-Asset, das sich im Besitz der aktuellen Organisation befindet.

PUT
/v1/videos/assets/{assetId}

Aktualisieren Sie asset_name oder metadata; senden Sie mindestens eines davon. Die Quell-URL und der Asset-Typ können nicht geändert werden; erstellen Sie ein neues Asset, wenn sich die Quelldatei ändert.

Nur ein ACTIVE Asset kann aktualisiert werden: Ein PROCESSING Asset gibt 409 mit seedance_material_preparing zurück, und ein FAILED Asset gibt 422 zurück.

project_name grenzt Ressourcen innerhalb Ihrer Organisation ab und ist standardmäßig auf default gesetzt. Verwenden Sie denselben, zwischen Groß- und Kleinschreibung unterscheidenden Wert für zugehörige Gruppen und Assets. Senden Sie ihn im JSON-Body für POST/PUT und im Query-String für GET/DELETE.

Beispielanfrage

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"}'

Beispielantwort

{
  "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}

Autorisierung

bearerAuth

Pfadparameter

assetId*string

TokenLab-Material-Asset-ID.

Anfragekörper

application/json

Aktualisieren Sie asset_name oder Metadaten. Die Quell-URL und der Asset-Typ können nicht geändert werden; erstellen Sie stattdessen ein neues Asset.

Eigenschaften1 <= properties

Antwort

application/json

application/json

application/json

application/json

application/json

application/json

application/json