Obtenez un atout

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/GetAsset

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

Lire un actif par ID. Utilisez cette route pour interroger un téléchargement asynchrone jusqu’à ce que Status soit Active ou Failed.

Champ	Type	Obligatoire	Descriptif	Exemple
Id	string	Oui	ID d’actif à interroger.	asset-20260528140922-d9646

Exemple JSON :

JSON

{
  "Id": "asset-20260528140922-d9646"
}

Exemple cURL :

bash

curl --request POST https://modelflare.dev/volc/asset/GetAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "Id": "asset-20260528140922-d9646"
}'

Réponse

La requête a réussi.

Champ	Type	Obligatoire	Descriptif	Exemple
Id	string	Oui	ID d’actif.	asset-20260528140922-d9646
Name	string	Non	Nom de l’actif.	character-reference
URL	string	Non	URL du fichier temporaire. La durée de vie documentée est de 12 heures ; ne le conservez pas comme référence de génération.	https://example.com/temporary-asset
AssetType	Image	Video	Audio	Non
GroupId	string	Non	ID de groupe propriétaire.	group-20260320141746-zsf6b
Status	Processing	Active	Failed	Non
ProjectName	string	Non	Nom du projet.	default
CreateTime / UpdateTime	string	Non	Horodatages ISO 8601.	2026-05-28T06:09:31Z

Exemple de réponse :

JSON

{
  "Id": "asset-20260528140922-d9646",
  "Name": "character-reference",
  "AssetType": "Image",
  "GroupId": "group-20260320141746-zsf6b",
  "Status": "Active",
  "ProjectName": "default",
  "CreateTime": "2026-05-28T06:09:22Z",
  "UpdateTime": "2026-05-28T06:09:31Z"
}

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.