Une clé, tous les modèles
28 modèles d'image, de vidéo et d'audio derrière une seule API REST et un seul solde de Gems. Change de modèle en modifiant le chemin de l'URL.
En un coup d’œil
Mage propose aux développeurs une API REST sur https://api.mage.space/v1 et un serveur MCP distant sur https://mcp.mage.space/mcp. Les deux font tourner les mêmes 28 modèles d'image, de vidéo et d'audio, dont les modèles exclusifs à Mage Mango 3 et Cherry 2 Pro, sur un seul compte, et chaque génération se paie en Gems, sans abonnement.
28
Modèles
3
Types de médias
16
Outils MCP
$0
Frais mensuels
Points d'entrée
Appelle-le depuis ton code, ton assistant ou ComfyUI
API REST
L'API Mage
Lance des générations depuis ton propre code avec une clé. Requêtes asynchrones, nouvelles tentatives idempotentes, envois de fichiers jusqu'à 100 Mo et 20 générations en parallèle.
SDK
SDK TypeScript et Python
Des clients officiels et typés qui envoient la requête, attendent le résultat, relancent en toute sécurité et téléversent des fichiers en quelques lignes.
Serveur MCP
Le serveur MCP de Mage
Connecte Claude, ChatGPT, Claude Code, Grok ou Cursor avec une simple connexion, et demande des images, des vidéos et de l'audio avec tes propres mots.
ComfyUI
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.
Par type de média
API de génération
15 modèles
API de génération d'images par IA
Texte vers image, retouche et personnages cohérents jusqu'en 4K.
12 modèles
API de génération de vidéos par IA
Texte vers vidéo, image vers vidéo, images clés, références et son.
1 modèle
API de génération d'audio par IA
Voix, narration, musique et effets sonores à partir d'un prompt.
Démarrage rapide
Ta première génération
Crée une clé dans API → Clés d'API, exporte-la sous le nom MAGE_API_KEY, puis lance l'un de ces exemples.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v3"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"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"])Comment ça marche
De la clé d'API au média final en trois appels
Tous les modèles partagent le même schéma d'authentification, le même cycle de requête asynchrone et les mêmes noms de champs.
Crée une clé d'API
Connecte-toi à Mage, ouvre API → Clés d'API et crée une clé. Elle commence par mage_sk_ et ne s'affiche qu'une seule fois. Un compte peut avoir 10 clés actives.
Lance une génération
Envoie en POST un corps JSON à https://api.mage.space/v1/{model}/generate avec un en-tête Authorization: Bearer. La réponse arrive immédiatement avec un request_id, un status et un status_url. Ajoute un en-tête Idempotency-Key pour qu'une nouvelle tentative ne soit jamais facturée deux fois.
Interroge et télécharge
Interroge status_url jusqu'à ce que le statut soit completed, failed ou cancelled. Une requête terminée contient result.url, qui pointe vers le fichier image, vidéo ou audio, conservé 30 jours.
MCP
Mage dans ton assistant IA
Mage dans Claude
Génère des images, des vidéos et de l'audio dans Claude sur le web, dans l'appli de bureau, dans les applis mobiles et dans Cowork.
Mage dans ChatGPT
Génère des images, des vidéos et de l'audio dans ChatGPT grâce à une appli MCP personnelle.
Mage dans Claude Code
Génère des images, des vidéos et de l'audio dans Claude Code, depuis ton terminal et ton éditeur.
Mage dans Grok
Génère des images, des vidéos et de l'audio dans Grok grâce à un connecteur personnalisé.
Mage dans Cursor
Génère des images, des vidéos et de l'audio en mode Agent de Cursor.
Modèles
Modèles à la une
Image · à partir de 40 Gems
API Flux 2
Prompts longs et retouches multi-références
Image · à partir de 9 Gems
API GPT Image 2
Prompts précis et texte lisible
Image · à partir de 37 Gems
API Guava
Un photoréalisme digne d'une vraie photo
Image · à partir de 135 Gems
API Mango
Notre famille d'images phare
Image · à partir de 68 Gems
API Nano Banana 2
Texte net et lisible, jusqu'en 4K
Vidéo · à partir de 618 Gems
API Cherry
Notre famille de vidéos phare
Vidéo · à partir de 245 Gems
API Lemon
Toutes les fonctions vidéo, à un prix plus doux
Vidéo · à partir de 338 Gems
API Plum
Du son sur chaque clip, jusqu'en 2K
Audio · à partir de 19 Gems
API Seed Audio
Voix, musique et effets sonores à partir d'un seul prompt
Conçue pour la production
Ce que reçoit chaque requête de l'API Mage
Paiement à la génération
Pas d'abonnement ni de dépense minimale. Tu achètes des Gems, et chaque requête est facturée au prix indiqué. Une génération qui échoue est remboursée, sauf si la politique de contenu de Mage l'a bloquée.
Nouvelles tentatives sans risque
Grâce aux clés d'idempotence, un nouvel envoi renvoie la requête d'origine sans te facturer une deuxième fois.
Personnages cohérents
Enregistre un personnage ou une référence une seule fois, puis écris @handle dans n'importe quel prompt pour l'utiliser avec tous les modèles compatibles.
Fichiers volumineux
Envoie des images, des vidéos et de l'audio sous forme d'URL ou de data URL, ou téléverse des fichiers jusqu'à 100 Mo via un envoi signé.
20 générations en parallèle
Chaque compte peut lancer 20 générations à la fois, et cette limite peut être relevée selon ton usage. Les requêtes refusées ne sont jamais facturées.
FAQ
Questions fréquentes
Qu'est-ce que l'API Mage ?
L'API Mage est une API REST disponible à l'adresse https://api.mage.space/v1 pour générer des images, des vidéos et de l'audio avec 28 modèles depuis ton propre code. Les requêtes sont asynchrones et payées à chaque génération en Gems.
Qu'est-ce que le serveur MCP de Mage ?
Un serveur Model Context Protocol distant, à l'adresse https://mcp.mage.space/mcp, qui permet aux assistants IA de générer des images, des vidéos et de l'audio sur ton compte Mage. Il donne à l'assistant 16 outils pour choisir un modèle, estimer le prix, générer, attendre le résultat et utiliser tes personnages, références et historique enregistrés.
Ai-je besoin d'une clé API pour utiliser le serveur MCP ?
Non. Claude, ChatGPT, Grok, Cursor et Claude Code se connectent en te faisant ouvrir une session Mage via OAuth. Une clé API est facultative, pour les configurations sans interface comme la CI.
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.
Quelles sont les limites de débit ?
Un compte peut avoir 20 générations en file d'attente ou en cours en même temps. Toute soumission au-delà est refusée avec une erreur 429 et ne coûte rien. Écris à [email protected] pour relever la limite selon ton cas d'usage.
Mon agent IA peut-il utiliser l'API Mage ?
Oui. Les agents peuvent appeler l'API REST avec une clé, ou se connecter au serveur MCP de Mage, qui donne à Claude, ChatGPT, Claude Code, Grok et Cursor seize outils prêts à l'emploi pour choisir un modèle, obtenir le prix, générer et récupérer le résultat. Consulte le serveur MCP.
Existe-t-il un SDK pour l'API Mage ?
Oui. Le package officiel @mage-space/sdk sur npm et mage-space sur PyPI sont open source et typés pour chaque modèle. Ils envoient la requête, attendent le résultat, réessaient en toute sécurité et téléversent les fichiers à ta place. Si tu utilises ComfyUI, tu peux installer le pack de nœuds comfyui-mage. Consulte les SDK Mage.
J'utilise déjà une autre API de génération. Que dois-je changer ?
Pointe ton client vers https://api.mage.space/v1, envoie ta clé Mage comme jeton Bearer et associe tes champs à ceux de la page du modèle : prompt, aspect_ratio, resolution, duration et model_id fonctionnent de la même façon pour tous les modèles Mage. Les requêtes sont asynchrones : envoie-les, puis interroge status_url.
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.