Aller au contenu principal

Glossaire développeur

Comprendre l’API avant de l’intégrer.

Des définitions pratiques pour choisir un modèle, gérer les états, vérifier les callbacks, estimer l’usage et protéger les médias des utilisateurs.

01

API de génération asynchrone

Définition

Une API qui accepte une demande média, renvoie un taskId durable et termine après la requête HTTP initiale.

Note d’implémentation

Enregistrez le taskId avant le polling ou le Webhook. queued et running sont actifs ; succeeded, failed et expired sont terminaux. Une tâche acceptée ne peut pas être annulée.

Page associée →
02

Clé d’idempotence

Définition

Un identifiant client qui rattache les renvois à une seule tâche logique et évite un travail facturable en double.

Note d’implémentation

Réutilisez la clé uniquement pour la même demande validée, stockez-la avec la tâche et restituez le résultat initial lors d’un nouvel essai.

Page associée →
03

Signature Webhook

Définition

Une valeur cryptographique permettant de vérifier que le callback vient de l’API et n’a pas été altéré.

Note d’implémentation

Vérifiez le corps brut, refusez les horodatages anciens et dédupliquez eventId avant de modifier tâche ou facturation.

Page associée →
04

Schéma du modèle

Définition

La spécification lisible par machine qui décrit les champs, types, limites, valeurs par défaut et forme de sortie.

Note d’implémentation

Générez formulaires et validation serveur depuis le schéma publié, puis conservez la version utilisée pour chaque tâche.

Page associée →
05

Image de référence

Définition

Une image d’entrée qui guide identité, composition, style ou mouvement lors d’une génération.

Note d’implémentation

Conservez provenance et consentement, validez le format ; une référence n’autorise pas à reproduire une personne réelle.

Page associée →
06

Tarification à l’usage

Définition

Le coût dépend de l’utilisation réelle. Chaque modèle précise l’unité applicable : image, seconde de sortie, mégapixel, token ou requête.

Note d’implémentation

Affichez l’unité et l’estimation avant exécution ; minimum, durée et nombre de sorties peuvent changer le total.

Page associée →
07

Modèle d’IA au filtrage allégé

Définition

Une option propre à certains modèles, avec moins de filtres. La mention est une information produit, pas une approbation de la plateforme.

Note d’implémentation

Avant l’envoi, mettez en place dans votre application les contrôles d’âge, de consentement, de personnes réelles et de juridiction requis pour vos utilisateurs.

Page associée →

Prêt à intégrer un modèle ?

Consultez les entrées, exemples et prix actuels, puis vérifiez l’estimation de vos réglages avant l’exécution.