API Mage · SDK
SDK officiels pour l'API Mage
Des clients typés pour TypeScript et Python, et des nodes Mage pour ComfyUI. Tous les modèles d'images, vidéos et audios en quelques lignes de code.
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 37 modèles, une interrogation automatique, des nouvelles tentatives idempotentes et les uploads.
- 3SDK et intégrations
- 37Modèles typés
- MITOpen source
- $0À installer
Choisis le tien
SDK et intégrations
npm install @mage-space/sdkSDK 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-spaceSDK 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-mageMage 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-v4',
});
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-v4",
})
print(request["result"]["url"])Intégré
Ce que chaque SDK gère pour toi
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.
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 ?
Les nouveaux modèles Mage fonctionnent-ils avec un ancien SDK ?
Comment les SDK évitent-ils de payer deux fois une requête renvoyée ?
Les SDK sont-ils stables ?
Combien coûte l'API Mage ?
Faut-il un abonnement Mage pour utiliser l'API ?
Puis-je utiliser les résultats de l'API à des fins commerciales ?
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.