Pourquoi l'API image est tarifée en coins (et se rembourse toute seule)

En construisant l'API publique au-dessus de Fellowi Images, nous avons dû prendre plusieurs décisions qui n'apparaissent pas dans la documentation comme des fonctionnalités - elles apparaissent comme l'absence de problèmes. Voici la logique derrière elles : pourquoi c'est tarifé en coins, ce qui se passe quand une génération échoue, et pourquoi deux ou trois chiffres de la doc (limites de débit, jours de rétention) comptent moins qu'ils n'en ont l'air.

Des coins, pas un abonnement

La génération d'image a un coût réel et variable par appel. Un abonnement mensuel fixe surfacture soit celui qui génère cinq images par mois, soit sous-facture celui qui en génère cinq cents - il n'y a pas de nombre de sièges ou de quota de requêtes qui se cale proprement là-dessus. Les coins font en sorte que le coût suive directement l'usage : vous payez ce que vous générez réellement, rien de plus. Les coins n'expirent jamais et il n'y a rien à annuler, ce qui veut aussi dire qu'il n'y a pas de cycle de facturation à surveiller - achetez un paquet quand vous en avez besoin, et il reste dans le portefeuille jusque-là.

Une génération ratée se rembourse toute seule

Si une génération expire ou est rejetée avant de produire une image, les coins que vous avez dépensés reviennent automatiquement et immédiatement. Ce n'est pas un ticket de support à ouvrir - c'est une propriété du système : vous n'êtes jamais facturé pour une image que vous n'avez pas reçue. Nous traitons cela comme une garantie de fiabilité, pas comme une faveur.

Chaque échec se résout en exactement un des quatre codes, volontairement peu nombreux :

• TIMEOUT - la génération a pris trop de temps et a été abandonnée.
• MODERATION_REJECTED - la requête a violé la politique de contenu.
• VENDOR_ERROR - quelque chose a échoué en amont, côté génération.
• UNKNOWN - un véritable code fourre-tout pour tout ce qui ne rentre pas dans les trois précédents.

Un ensemble petit et fixe de codes est un choix délibéré - c'est quelque chose sur lequel vous pouvez réellement écrire un switch, plutôt que de faire du pattern-matching sur des chaînes d'erreur libres susceptibles de changer sous vos pieds.

Les images expirent au bout de 30 jours

Les données de l'image générée sont conservées 30 jours. Passé ce délai, l'historique de la génération existe toujours - votre endpoint de liste montre toujours que ça a eu lieu, quand, et ce que ça a coûté - mais récupérer le contenu réel de l'image renvoie un HTTP 410 Gone. C'est un compromis de coût de stockage clair, pas caché : si vous voulez conserver une image au-delà de 30 jours, téléchargez-la et stockez-la vous-même. Nous ne supprimons jamais silencieusement l'enregistrement de la génération, seulement les données.

Les limites de débit ne sont pas le vrai plafond

La limite de débit par minute sur votre clé API (20 requêtes par minute pour la génération, 120 pour la lecture, par défaut) existe pour freiner les abus, pas pour être ce qui limite réellement combien d'images vous pouvez faire. Votre solde de Fellowi Coins est le vrai plafond - si vous avez les coins, vous pouvez les dépenser, jusqu'à ce débit. Si vous voulez un budget plus serré que ce que votre solde permet, une clé peut aussi porter un plafond quotidien de coins optionnel que vous définissez vous-même, pour votre propre contrôle des coûts plutôt que le nôtre.

Des clés que vous ne pouvez pas récupérer

Une clé API vous est montrée exactement une fois, à sa création. Après cela, seuls un hash et un court aperçu sont stockés de notre côté - la même posture que pour n'importe quel autre secret du produit. Si vous perdez une clé, vous en générez une nouvelle ; il n'y a pas de procédure de récupération, parce qu'il n'y a rien de notre côté capable de la récupérer.

Même portefeuille, même prix

L'API et l'application web dépensent exactement le même solde de Fellowi Coins, au même prix par palier de qualité - 40 coins pour Standard, 60 pour la haute qualité. Il n'y a pas de « tarification API » séparée. C'est délibéré : votre coût est prévisible quelle que soit la porte par laquelle vous générez.

Pour les formats réels de requête/réponse et des exemples de code fonctionnels, voyez notre guide de démarrage rapide de l'API, ou allez directement à la Console API pour créer une clé.