Un appel, un média prêt
run envoie la génération, interroge l'API avec le backoff qu'elle recommande et renvoie la requête terminée avec result.url.
En un coup d’œil
Mage publie des SDK open source pour son API : @mage-space/sdk sur npm pour TypeScript et JavaScript, mage-space sur PyPI pour Python, et le pack de nodes comfyui-mage pour ComfyUI. Chacun encapsule l'API REST avec des configs typées pour les 28 modèles, un polling automatique, des nouvelles tentatives idempotentes et des uploads.
3
SDK et intégrations
28
Modèles typés
MIT
Open source
$0
À installer
Choisis le tien
SDK et intégrations
npm install @mage-space/sdk
SDK TypeScript
Génère des images, vidéos et audios depuis Node.js avec des configs typées pour chaque modèle Mage. Un seul appel envoie, attend et renvoie le résultat.
pip install mage-space
SDK Python
Génère des images, vidéos et audios depuis Python avec des clients sync et asyncio et des configs typées pour chaque modèle Mage.
comfy node install comfyui-mage
Mage pour ComfyUI
Mango, Cherry, Seed Audio et tous les autres modèles Mage sous forme de nœuds ComfyUI. Pas de GPU, pas de modèles à télécharger.
Démarrage rapide
Ta première génération avec un SDK
Installe le package, exporte MAGE_API_KEY et lance un modèle.
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('mango', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'mango-v3',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("mango", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v3",
})
print(request["result"]["url"])Intégré
Ce que chaque SDK gère pour toi
Des nouvelles tentatives sans double paiement
Chaque envoi porte une clé d'idempotence. Les erreurs réseau et serveur sont retentées avec backoff, et un envoi retenté n'est jamais facturé deux fois.
Uploads en un appel
Les fichiers trop volumineux pour une data URL passent par un upload signé, avec le ticket, le PUT et la vérification de taille gérés pour toi.
Des erreurs claires
Les refus de l'API incluent leur statut HTTP, leur code d'erreur et leur identifiant de requête ; les générations échouées ou annulées et les délais dépassés ont leurs propres types d'erreur.
Packages
Où les trouver
| SDK | Package | Installation | Source |
|---|---|---|---|
| SDK TypeScript | @mage-space/sdk | npm install @mage-space/sdk | GitHub |
| SDK Python | mage-space | pip install mage-space | GitHub |
| Mage pour ComfyUI | comfyui-mage | comfy node install comfyui-mage | GitHub |
FAQ
Questions fréquentes
Les SDK Mage sont-ils gratuits et open source ?
Oui. Les SDK et les nœuds ComfyUI sont sous licence MIT sur GitHub, et leur installation est gratuite. Tu paies uniquement les générations que tu lances, en Gems, au prix indiqué pour chaque modèle.
Les nouveaux modèles Mage fonctionnent-ils avec un ancien SDK ?
Oui. Passe l’identifiant du nouveau modèle sous forme de chaîne et il s’exécute ; le SDK vérifie sa configuration avec les champs communs à tous les modèles. Un bot met à jour les types dès que la référence de l’API change, donc les nouveaux modèles arrivent avec leurs propres types dans la version suivante.
Comment les SDK évitent-ils de payer deux fois une requête renvoyée ?
Chaque envoi comporte une Idempotency-Key. Le SDK crée une nouvelle clé à chaque appel et la réutilise quand il relance lui-même cet appel : un envoi renvoyé retourne donc la requête d’origine et ne coûte rien.
Les SDK sont-ils stables ?
Ils sont en bêta en version 0.x, donc une version mineure peut encore les modifier. L’API elle-même suit son propre versionnement et reste stable dans la v1.
Combien coûte l'API Mage ?
Il n'y a ni abonnement ni frais mensuels. Chaque génération est payée en Gems au prix indiqué pour son modèle, et 1 000 Gems coûtent 1 $ avec le pack standard. La page de chaque modèle indique son prix avec les réglages par défaut, et chaque réponse précise le montant exact débité. Une génération qui échoue est remboursée ; celle que la politique de contenu de Mage bloque ne l'est pas. Une requête que ton solde ne peut pas couvrir est refusée avant tout débit.
Faut-il un abonnement Mage pour utiliser l'API ?
Non. L'API fonctionne uniquement avec des Gems. Les abonnements et leur génération illimitée dans l'appli ne s'appliquent pas aux requêtes API : n'importe quel compte Mage avec des Gems peut donc l'utiliser.
Puis-je utiliser les résultats de l'API à des fins commerciales ?
Oui. Tu peux utiliser à des fins commerciales les contenus créés avec Mage, y compris via l'API et le serveur MCP. La mention de la source est appréciée, mais pas obligatoire.
Lance-toi avec Mage
Un seul compte, un seul solde de Gems, tous les modèles. Ne paie que ce que tu génères.