Video & Materialien

Material-Assets auflisten

Listet Seedance-Materialien auf, die der aktuellen Organisation gehören.

GET
/v1/videos/assets

Listen Sie Materialien in Ihrer Organisation und Ihrem Projekt auf. Filtern Sie nach library_type, group_id oder status (PROCESSING, ACTIVE, FAILED, DELETED). page_size akzeptiert Werte von 1–100 (Standardwert 20). Übergeben Sie next_page_token aus einer Antwort als page_token, um die nächste Seite zu lesen.

Verwenden Sie nur Assets, deren status auf ACTIVE gesetzt ist. Verwenden Sie die zurückgegebene TokenLab Material-Asset-id beim Erstellen von Videos.

project_name grenzt Ressourcen innerhalb Ihrer Organisation ein und ist standardmäßig auf default gesetzt. Verwenden Sie denselben, groß-/kleinschreibungssensitiven 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?library_type=aigc_avatar&group_id=group-20260720123456-vrt01&page_size=20&project_name=default" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

Beispielantwort

{
  "assets": [
    {
      "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,
      "created_at": 1782998400000,
      "updated_at": 1782998400000
    }
  ],
  "next_page_token": null
}
curl -X GET "https://example.com/v1/videos/assets"
{  "assets": [    {      "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    }  ],  "next_page_token": null}

Autorisierung

BearerAuth
AuthorizationBearer <token>

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

Ort: header

Abfrageparameter

page_size?integer
Bereich1 <= value <= 100
Standard20
page_token?string
group_id?string

Nach TokenLab-Material-Asset-Gruppen-ID filtern.

status?string

Zulässige Werte

  • "PROCESSING"
  • "ACTIVE"
  • "FAILED"
  • "DELETED"
library_type?string

Nach Material-Bibliotheksklasse filtern.

Zulässige Werte

  • "aigc_avatar"
  • "liveness_face"
project_name?string

Projektbereich für die Materialressource.

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

Antwort

application/json

application/json

application/json

application/json