Questions fréquentes sur la bibliothèque de ressources

Questions fréquentes

Le groupe créé dans la console n'apparaît pas dans l'interface

Les groupes créés dans la console apparaissent dans GET /api/v1/materials/groups. Si vous ne disposez que de l'ID du groupe, vous pouvez aussi l'utiliser directement comme group_id dans POST /api/v1/materials/assets ; la plateforme vérifie d'abord que le groupe existe, puis le rattache au compte actuel, après quoi il apparaîtra dans la liste des groupes.

Où consulter la cause d'un échec de validation

Le champ data.asset.error_message renvoyé par l'interrogation de la ressource correspond à la cause de l'échec ; il n'a de contenu que lorsque status vaut Failed, et vaut null pour les statuts normaux et disponibles.

Combien de temps prend la validation d'une image

La validation et le prétraitement sont asynchrones ; la durée dépend de la ressource elle-même, et la plateforme ne garantit pas une durée uniforme pour toutes les images. Le programme doit interroger le même ID de ressource de façon répétée, et ne pas soumettre à nouveau simplement parce que l'état initial est Processing.

Les interrogations fréquentes sont-elles limitées

L'interrogation de statut est une interface légère, mais n'envoyez pas de requêtes concurrentes répétées dans un même cycle d'interrogation ; il est recommandé d'interroger le même ID de ressource toutes les 5 à 10 secondes. En cas de requêtes trop fréquentes, l'interface renvoie HTTP 429 ; réessayez plus tard, les ressources déjà soumises ne sont pas affectées.

Quelles sont les exigences concernant l'adresse d'image

Il doit s'agir d'une adresse http(s) directement téléchargeable par le serveur de la plateforme (http et https sont pris en charge), sans dépendre de cookies, de Referer, d'une page de connexion ni d'une liste blanche d'IP. Si l'image est derrière une adresse nécessitant une connexion, sur un réseau interne, ou uniquement disponible en fichier local, transférez-la d'abord vers un stockage objet ou utilisez data_url, sinon le traitement de la ressource échouera.

Si une adresse publique peut être fournie, privilégiez image_url : la plateforme transmet l'adresse telle quelle, sans téléchargement ni transfert, ce qui accélère la soumission ; data_url nécessite l'import du base64 de l'image entière, est nettement plus lent et occupe le stockage de la plateforme.