Video & Materialien

Material-Asset abrufen

Ruft ein Seedance Material-Asset über die TokenLab Material-Asset-ID ab.

GET
/v1/videos/assets/{assetId}

Rufen Sie ein Material-Asset ab und überprüfen Sie dessen Verarbeitungsstatus: PROCESSING, ACTIVE, FAILED oder DELETED. Das Asset kann nur dann für die Videogenerierung verwendet werden, wenn ready auf true und status auf ACTIVE gesetzt ist. Wenn die Verarbeitung fehlschlägt, gibt error_message den Grund dafür an.

Wenn die Videogenerierung 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 grenzt Ressourcen innerhalb Ihrer Organisation ein und ist standardmäßig auf default gesetzt. Verwenden Sie für zusammengehörige Gruppen und Assets denselben, zwischen Groß- und Kleinschreibung unterscheidenden Wert. Senden Sie diesen 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?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,
  "updated_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