Assets auflisten

Verfügbarkeit

Diese Seite dokumentiert den Asset-Management-Weg von Modelflare. Für Aufrufe sind ein gültiger Smart-API-Schlüssel oder Mediengruppen-API-Schlüssel, ein verfügbarer Medienkanal und die erforderliche Berechtigung erforderlich.

Hinweis

Das Gateway zeichnet die Asset-IDs, den Status und den Benutzerbesitz des Anbieters auf. Die lokale Castaly-Bibliothek bleibt vom Asset-Namespace des Anbieters getrennt.

Endpunkt

POST https://modelflare.dev/volc/asset/ListAssets

Authentifizierung

Verwenden Sie einen Modelflare-API-Schlüssel:

bash

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Senden Sie Idempotency-Key mit Anfragen zum Erstellen, Aktualisieren und Löschen. Wenn Sie denselben Schlüssel für denselben Benutzer erneut versuchen, wird die gespeicherte Antwort erneut abgespielt, ohne dass die Mutation wiederholt wird.

Anfrage

Assets mit optionalen Namens-, Gruppen- und Gruppentypfiltern auflisten. Warten Sie auf Status: Active, bevor Sie eine ID in einer Seedance-Anfrage verwenden.

Feld	Typ	Erforderlich	Beschreibung	Beispiel
model	string	Ja	Abrechnungsmodell. Standardmäßig ist volc-asset.	volc-asset
Filter.Name	string	Nein	Fuzzy-Asset-Namensfilter.	character
Filter.GroupIds	string[]	Nein	Nach Gruppen-IDs filtern.	["group-20260320141746-zsf6b"]
Filter.GroupType	AIGC	LivenessFace	Nein	Nach Gruppentyp filtern.
PageNumber	integer	Nein	Seitenzahl. Standardmäßig ist 1.	1
PageSize	integer	Nein	Elemente pro Seite. Standardmäßig ist 10.	10

JSON-Beispiel:

JSON

{
  "model": "volc-asset",
  "Filter": {
    "Name": "character",
    "GroupIds": [
      "group-20260320141746-zsf6b"
    ],
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}

cURL-Beispiel:

bash

curl --request POST https://modelflare.dev/volc/asset/ListAssets \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "volc-asset",
  "Filter": {
    "Name": "character",
    "GroupIds": [
      "group-20260320141746-zsf6b"
    ],
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}'

Antwort

Die Anfrage war erfolgreich.

Feld	Typ	Erforderlich	Beschreibung	Beispiel
Items[]	object[]	Nein	Asset-Objekte mit Identität, Typ, Gruppe, Status, Projekt und Zeitstempeln.	{ Id, Name, AssetType, GroupId, Status, ... }
Items[].Id / Name	string	Nein	Asset-Identität und Anzeigename.	asset-20260528140922-d9646 / character-reference
Items[].AssetType / GroupId	string	Nein	Asset-Typ und Eigentümergruppe.	Image / group-20260320141746-zsf6b
Items[].Status / ProjectName	string	Nein	Bearbeitungsstatus und Projektname.	Active / default
Items[].CreateTime / UpdateTime	string	Nein	ISO 8601-Erstellungs- und Aktualisierungszeitstempel.	2026-03-20T14:25:01Z
Items[].URL	string	Nein	Temporäre Datei-URL. Die dokumentierte Lebensdauer beträgt 12 Stunden; Verwenden Sie asset://<ID> für Generierungsanforderungen.	https://example.com/temporary-asset
Items[].Error	object	Nein	Verarbeitungsfehler bei Code und Message, wenn Status Failed ist.	{ Code, Message }
PageNumber	integer	Nein	Zurückgegebene Seitenzahl.	1
PageSize	integer	Nein	Zurückgegebene Seitengröße.	10
TotalCount	integer	Nein	Gesamte Matching-Assets.	2

Antwortbeispiel:

JSON

{
  "Items": [
    {
      "Id": "asset-20260528140922-d9646",
      "Name": "character-reference",
      "AssetType": "Image",
      "GroupId": "group-20260320141746-zsf6b",
      "Status": "Active",
      "ProjectName": "default"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1
}

Fehler

Status	Bedeutung
400	Die Anfrage ist ungültig.
401	Der API-Schlüssel fehlt oder ist nicht autorisiert.

Beispiel für einen Fehlertext (bei Rückgabe):

JSON

{
  "error": {
    "code": "invalid_request",
    "message": "Request validation failed."
  }
}

Die Erstellung von Bildern, Videos und Audio erfolgt asynchron. Rufen Sie nach Erhalt einer Asset-ID GetAsset auf und verwenden Sie die asset://<ID>-Referenz nur, wenn der Status Active ist.