Asset-Gruppen 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/ListAssetGroups

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

Listen Sie Gruppen mit optionalen Namens-, ID- und Gruppentypfiltern auf. Für Lesevorgänge fallen keine Generierungsgebühren an.

Feld	Typ	Erforderlich	Beschreibung	Beispiel
model	string	Ja	Abrechnungsmodell. Standardmäßig ist volc-asset.	volc-asset
Filter.Name	string	Nein	Fuzzy-Namensfilter.	my-project
Filter.GroupIds	string[]	Nein	Exakter Filter nach einer Liste von Gruppen-IDs.	["group-20260320141746-zsf6b"]
Filter.Id	string	Nein	Exakter Filter nach einer Gruppen-ID.	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": "my-project",
    "GroupIds": [
      "group-20260320141746-zsf6b"
    ],
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}

cURL-Beispiel:

bash

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

Antwort

Die Anfrage war erfolgreich.

Feld	Typ	Erforderlich	Beschreibung	Beispiel
Items[]	object[]	Nein	Asset-Gruppen mit Id, Name, GroupType und Status.	{ Id, Name, GroupType, Status }
Items[].Id / Name	string	Nein	Gruppenidentität und Anzeigename.	group-20260320141746-zsf6b / my-project-assets
Items[].GroupType / Status	string	Nein	Gruppentyp und aktueller Status.	AIGC / Active
PageNumber	integer	Nein	Zurückgegebene Seitenzahl.	1
PageSize	integer	Nein	Zurückgegebene Seitengröße.	10
TotalCount	integer	Nein	Gesamtzahl übereinstimmender Gruppen.	1

Antwortbeispiel:

JSON

{
  "Items": [
    {
      "Id": "group-20260320141746-zsf6b",
      "Name": "my-project-assets",
      "GroupType": "AIGC",
      "Status": "Active"
    }
  ],
  "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.