MuoGen pour les développeurs
L’API MuoGen pour les images et vidéos IA
MuoGen propose une API versionnée pour les modèles d’images et de vidéos disponibles. Son URL de base en production est https://muogen.com/api/v1.
Comment obtenir une clé API ?
Connectez-vous à votre compte MuoGen et ouvrez « API keys » dans le menu du profil. Lorsque le service est configuré, créez une clé et copiez-la immédiatement : elle n’est affichée qu’une fois. Conservez-la dans une configuration privée de votre serveur, par exemple MUOGEN_API_KEY, et transmettez-la dans l’en-tête Authorization: Bearer.
La clé autorise les demandes de votre compte. Ne l’intégrez pas à un fichier JavaScript public, à un dépôt accessible ni à une URL. Révoquez une clé depuis le compte lorsque vous ne souhaitez plus autoriser de nouvelles demandes avec elle.
Quel est le parcours d’une demande ?
- Consultez
GET /modelspour obtenir le catalogue disponible et préparer les entrées compatibles. - Demandez un devis avec
POST /quotespour les paramètres choisis. - Soumettez une demande autorisée à
POST /generations. - Consultez l’état de la demande avant de renouveler une soumission incertaine.
L’espace « API keys », accessible après connexion, fournit des exemples de demandes et un historique. Utilisez les identifiants du catalogue disponible plutôt que de supposer qu’un modèle absent est pris en charge.
Comment limiter les dépenses ?
Les générations par API consomment des crédits payants. Les demandes facturées à l’usage nécessitent un plafond maxCostUsd. Les crédits réservés qui ne sont pas utilisés sont rendus après vérification de la facturation ; une génération échouée restitue la réservation. Le montant facturé ne dépasse pas le plafond envoyé.
Les crédits de test ne permettent pas de payer des générations par API. Une clé créée ne suffit pas à rendre chaque demande disponible : le service doit être configuré et le compte doit disposer de crédits payants adaptés à la demande.
Comment éviter les demandes en double ?
Utilisez une valeur Idempotency-Key stable pour chaque génération et conservez-la lors d’une nouvelle tentative de la même soumission. Après une interruption de connexion, vérifiez l’état de la demande avant de la soumettre de nouveau. Un nouveau projet ou une demande volontairement distincte doit utiliser sa propre clé d’idempotence.
La révocation d’une clé bloque les nouvelles demandes. Les générations déjà engagées continuent leur traitement et leur règlement ; révoquer une clé ne supprime pas leur consommation autorisée.
Quel lien avec les outils du navigateur ?
L’API et les espaces interactifs ont des parcours d’accès distincts. La génération payante dans les espaces publics du navigateur n’est pas encore ouverte pendant la connexion des services de compte et de facturation à l’usage. Consultez les questions sur l’API et la disponibilité des outils avant de préparer votre intégration.
Mise à jour: