Video & Materialien

Material-Asset abrufen

Ruft ein Seedance-Material-Asset anhand der TokenLab-Material-Asset-ID ab.

GET
/v1/videos/assets/{assetId}

Rufen Sie ein Material-Asset ab und überprüfen Sie dessen Verarbeitungsstatus. Das Asset kann nur dann für die Videogenerierung verwendet werden, wenn ready auf true und status auf ACTIVE gesetzt ist.

Wenn die Videogenerierung die Meldung Seedance material asset not found or not accessible zurückgibt, stellen Sie sicher, dass Sie die id dieses Material-Assets übergeben haben und nicht die group_id des Materials.

project_name trennt Ressourcen innerhalb der authentifizierten Organisation. Der Standard ist default; verwenden Sie für zugehörige Gruppen und Assets denselben Wert mit gleicher Groß- und Kleinschreibung. Senden Sie ihn bei POST/PUT im JSON-Body und bei GET/DELETE als Query-Parameter.

Beispielanfrage

curl "https://api.tokenlab.sh/v1/videos/assets/asset-20260720123456-qn7wr?project_name=default" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

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",
  "asset_type": "Image",
  "status": "ACTIVE",
  "ready": true,
  "error_message": null,
  "metadata": null,
  "created_at": 1782998400000
}
curl -X GET "https://example.com/v1/videos/assets/asset-20260720123456-qn7wr"
{  "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": "ACTIVE",  "ready": true,  "error_message": null,  "metadata": null,  "created_at": 1782998400000}

Autorisierung

BearerAuth
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Pfadparameter

assetId*string

Abfrageparameter

project_name?string

Projektbereich für die Materialressource.

Länge1 <= length <= 128
Standard"default"

Antwort

application/json

application/json

application/json

application/json

application/json