Répertorier les groupes d'actifs

Disponibilité

Cette page documente l’itinéraire de gestion des actifs de Modelflare. Les appels nécessitent une clé API intelligente ou une clé API de groupe multimédia valide, un canal multimédia disponible et l’autorisation requise.

Note

La passerelle enregistre les ID d’actif du fournisseur, le statut et la propriété de l’utilisateur. La bibliothèque locale Castaly reste distincte de l’espace de noms des actifs du fournisseur.

Point de terminaison

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

Authentification

Utilisez une clé API Modelflare :

bash

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Envoyez Idempotency-Key avec les demandes de création, de mise à jour et de suppression. Réessayer la même clé pour le même utilisateur rejoue la réponse enregistrée sans répéter la mutation.

Demande

Répertorie les groupes avec des filtres facultatifs de nom, d’ID et de type de groupe. Les lectures n’entraînent pas de frais de génération.

Champ	Type	Obligatoire	Descriptif	Exemple
model	string	Oui	Modèle de facturation. La valeur par défaut est volc-asset.	volc-asset
Filter.Name	string	Non	Filtre de noms flous.	my-project
Filter.GroupIds	string[]	Non	Filtre exact par une liste d’identifiants de groupe.	["group-20260320141746-zsf6b"]
Filter.Id	string	Non	Filtre exact par un ID de groupe.	group-20260320141746-zsf6b
Filter.GroupType	AIGC	LivenessFace	Non	Filtrer par type de groupe.
PageNumber	integer	Non	Numéro de page. La valeur par défaut est 1.	1
PageSize	integer	Non	Articles par page. La valeur par défaut est 10.	10

Exemple JSON :

JSON

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

Exemple cURL :

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
}'

Réponse

La requête a réussi.

Champ	Type	Obligatoire	Descriptif	Exemple
Items[]	object[]	Non	Groupes d’actifs avec Id, Name, GroupType et Status.	{ Id, Name, GroupType, Status }
Items[].Id / Name	string	Non	Identité du groupe et nom d’affichage.	group-20260320141746-zsf6b / my-project-assets
Items[].GroupType / Status	string	Non	Type de groupe et état actuel.	AIGC / Active
PageNumber	integer	Non	Numéro de page renvoyé.	1
PageSize	integer	Non	Taille de la page renvoyée.	10
TotalCount	integer	Non	Total des groupes correspondants.	1

Exemple de réponse :

JSON

{
  "Items": [
    {
      "Id": "group-20260320141746-zsf6b",
      "Name": "my-project-assets",
      "GroupType": "AIGC",
      "Status": "Active"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1
}

Erreurs

Statut	Signification
400	La demande n’est pas valide.
401	La clé API est manquante ou non autorisée.

Exemple de corps d’erreur (une fois renvoyé) :

JSON

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

La création d’images, de vidéos et d’audio est asynchrone. Après avoir reçu un ID d’actif, appelez GetAsset et utilisez la référence asset://<ID> uniquement lorsque l’état est Active.