Passer au contenu

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/v1

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 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

  • 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

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.

  1. 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.

  2. 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.

  3. 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 42 Gems

    API Mango

    Notre famille d'images phare

  • Image · à partir de 51 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 173 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

  • 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 ?
L'API Mage est une API REST sur https://api.mage.space/v1 pour générer des images, des vidéos et de l'audio avec 37 modèles depuis ton propre code. Les requêtes sont asynchrones et payées à la 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’app ne s’appliquent pas aux requêtes API. Le compte doit d’abord avoir effectué un paiement réussi, quel que soit le pack de Gems ou l’abonnement ; les Gems offerts à l’inscription ne fonctionnent que dans l’app Mage.
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.

CharactersCommunauté