Guide d'intégration GloopAPI
Facturation
Comprendre réservation, règlement et stockage de fichiers.
Le catalogue de modèles, les résumés de prix publics et la comptabilité des appels sont des informations distinctes. Avant toute opération facturable, l'application doit vérifier le modèle ou l'outil, les entrées et le budget ; un solde suffisant ne garantit pas l'autorisation d'appel.
Réservation et règlement
À l'acceptation d'une requête, un montant estimé peut être réservé. Après réception de l'utilisation faisant autorité, le règlement applique les prix figés et prélève ou rembourse la différence. Un devis vidéo à l'utilisation est une estimation, pas un plafond de dépense garanti. La réservation maximale d'un outil est calculée à partir des limites d'entrée et des règles figées ; le plafond de coût est contrôlé à la création.
status=succeeded décrit le résultat de l'exécution ; billing.status=reserved indique encore un coût à confirmer. Un montant final vide ne signifie pas zéro. Une soumission inconnue au service ou des données d'utilisation contradictoires maintiennent la réservation jusqu'à vérification ; le remboursement d'un échec confirmé dépend de l'interface et des preuves d'utilisation. Tous les échecs ne peuvent pas être garantis gratuits.
Pour le texte synchrone, consultez la consommation finale dans les relevés d'utilisation de la plateforme ; pour les tâches asynchrones, consultez leur état comptable. Ne relancez pas une génération pour tenter de régler une ancienne tâche.
Capacités tarifaires des outils
pricing.mode distingue flat, prix constant par appel, input, calcul préalable selon les entrées, et usage, calcul selon l'utilisation finale ; schema_version indique uniquement le format de la règle. Le champ amount de flat est le prix constant complet, y compris un prix nul ; input/usage ne fournissent pas de montant constant trompeur.
pricing.quote_required détermine si un nouvel appel exige un devis ; requires_usage indique si le règlement final nécessite une utilisation faisant autorité, y compris les contraintes de règlement de la plateforme. Même avec un prix de vente flat, un devis et l'utilisation finale peuvent être nécessaires ; décidez selon ces deux champs. Avec requires_usage=true, fournissez max_cost_usd couvrant maximum_usd, puis attendez l'utilisation faisant autorité après réussite avant le règlement. Une règle input ne nécessitant pas d'utilisation finale peut être réglée selon le montant d'entrée après devis, sans attendre les données du service.
metered_pricing limite uniquement les nouveaux appels nécessitant une utilisation finale ; il ne limite pas les règles constantes ou d'entrée qui n'en ont pas besoin et ne bloque ni la consultation d'exécutions acceptées, ni la répétition idempotente de la requête d'origine, ni la récupération comptable figée. Le devis lie la Key, la version de l'outil, les entrées normalisées et la configuration du prix et de la source. Même pour un outil à prix constant, tout quote_id fourni est vérifié. Le premier palier affiché au catalogue ne signifie pas que l'outil est gratuit.
Conservation des fichiers et espace
Les fichiers API ordinaires archivés expirent selon la durée de conservation du déploiement. Les images et vidéos persistantes sont conservées à long terme grâce à la protection par références ; expires_at=0 signifie aucune expiration programmée. L'occupation du stockage et le coût de génération sont calculés séparément ; le téléchargement n'est pas garanti avant ready.
Supprimer une tâche persistante efface ses résultats et libère les références supprimables ; les fichiers non partagés sont nettoyés en arrière-plan. Les références partagées ainsi que les enregistrements comptables et d'idempotence sont conservés. Supprimer un fichier ou échouer à le sauvegarder ne rembourse pas automatiquement les frais de génération déjà engagés. Une nouvelle tentative de sauvegarde réserve l'espace disponible et réutilise le résultat initial sans nouvelle génération.
Quota insuffisant
En cas de 403, 402 ou d'erreur de quota, vérifiez d'abord les limites du compte et de la Key. L'authentification persistante permet à une Key valide mais épuisée de lire l'historique, mais toute nouvelle tâche exige un budget. Pour régler une tâche existante, continuez à consulter l'enregistrement initial ; ne la resoumettez pas avec une autre Key ou clé de requête. Voir Authentification et Tâches asynchrones et idempotence.