API Mage · Conçue pour votre prochaine idée
Une API. Des possibilités infinies.
Intègre le meilleur de Mage à ton produit et à ton assistant IA. Génère des images, des vidéos et de l'audio avec une seule clé d'API ou une seule connexion MCP.
https://api.mage.space/v1En 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 37 modèles d'image, de vidéo et d'audio, dont Mango 4 et Cherry 2 Pro, exclusifs à Mage, avec un seul compte, et chaque génération se paie en Gems, sans abonnement.
- 37Modèles
- 3Types de médias
- 16Outils MCP
- $0Frais mensuels
Points d'entrée
Appelle-le depuis ton code, ton assistant ou ComfyUI
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 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.
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.
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
API de génération d'images par IA
Texte vers image, retouche et personnages cohérents jusqu'en 4K.
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.
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-v4"
}' | 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-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"])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
API Flux 2
Prompts longs et retouches multi-références
API GPT Image 2
Prompts précis et texte lisible
API Guava
Un photoréalisme digne d'une vraie photo
API Mango
Notre famille d'images phare
API Nano Banana 2
Texte net et lisible, jusqu'en 4K
API Cherry
Notre famille de vidéos phare
API Lemon
Toutes les fonctions vidéo, à un prix plus doux
API Plum
Du son sur chaque clip, jusqu'en 2K
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
Une clé, tous les modèles
37 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.
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 ?
Qu'est-ce que le serveur MCP de Mage ?
Ai-je besoin d'une clé API pour utiliser le serveur MCP ?
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 ?
Quelles sont les limites de débit ?
Mon agent IA peut-il utiliser l'API Mage ?
Existe-t-il un SDK pour l'API Mage ?
J'utilise déjà une autre API de génération. Que dois-je changer ?
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.