Liste des 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/ListAssets

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épertoriez les actifs avec des filtres facultatifs de nom, de groupe et de type de groupe. Attendez Status: Active avant d’utiliser un ID dans une requête Seedance.

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 nom d’actif flou.	character
Filter.GroupIds	string[]	Non	Filtrer par 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": "character",
    "GroupIds": [
      "group-20260320141746-zsf6b"
    ],
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}

Exemple cURL :

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

Réponse

La requête a réussi.

Champ	Type	Obligatoire	Descriptif	Exemple
Items[]	object[]	Non	Objets d’actif avec identité, type, groupe, statut, projet et horodatage.	{ Id, Name, AssetType, GroupId, Status, ... }
Items[].Id / Name	string	Non	Identité de l’actif et nom d’affichage.	asset-20260528140922-d9646 / character-reference
Items[].AssetType / GroupId	string	Non	Type d’actif et groupe propriétaire.	Image / group-20260320141746-zsf6b
Items[].Status / ProjectName	string	Non	État du traitement et nom du projet.	Active / default
Items[].CreateTime / UpdateTime	string	Non	Horodatages de création et de mise à jour ISO 8601.	2026-03-20T14:25:01Z
Items[].URL	string	Non	URL du fichier temporaire. La durée de vie documentée est de 12 heures ; utilisez asset://<ID> pour les requêtes de génération.	https://example.com/temporary-asset
Items[].Error	object	Non	Erreur de traitement avec Code et Message lorsque Status est Failed.	{ Code, Message }
PageNumber	integer	Non	Numéro de page renvoyé.	1
PageSize	integer	Non	Taille de la page renvoyée.	10
TotalCount	integer	Non	Total des actifs correspondants.	2

Exemple de réponse :

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
}

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.