En un coup d’œil
L'API Mage exécute 15 modèles d'image, 12 modèles de vidéo et 1 modèle audio sur https://api.mage.space/v1/{model}/generate. Tous les modèles utilisent la même clé, le même cycle de requête et les mêmes noms de champs, et se paient à la génération en Gems.
15
Modèles d'image
12
Modèles vidéo
1
Modèles audio
1
Une seule clé API pour tous
Modèles d'image
Modèles de génération d'images
Les prix s'entendent par génération, en Gems. 1 000 Gems coûtent 1 $ avec le pack standard, et les packs plus grands ajoutent des Gems bonus. Le prix dépend du modèle, de la résolution et de la durée ; c'est le prix avec les réglages par défaut qui est affiché, et chaque réponse indique le montant exact débité dans billing.gems_charged. Une génération qui échoue est remboursée ; celle bloquée par la politique de contenu de Mage ne l'est pas.
| Modèle | Idéal pour | Valeurs de model_id | Prix par défaut |
|---|---|---|---|
| Anima | Conçu spécialement pour l'anime | anima-v1 | 20 Gems ($0.02) |
| Chroma | Poids ouverts, basé sur Flux | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | Longs prompts et retouches multi-références | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | Prompts précis et texte lisible | gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine, en trois niveaux de qualité | grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0 | 75 Gems ($0.075) |
| Guava | Un photoréalisme qui passe pour une vraie photo | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | Rapide et polyvalent, avec prompts négatifs | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | Une esthétique superbe en quelques secondes | krea-2-turbo | 20 Gems ($0.02) |
| Mango | Notre famille de modèles d'images phare | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo | 135 Gems ($0.135) |
| Nano Banana 2 | Texte net et lisible, jusqu'en 4K | nano-banana-v2 | 68 Gems ($0.068) |
| SDXL Plus | SDXL avec visages et mains corrigés | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Stable Diffusion v1.5 | Le classique, à petit prix | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | Le Stable Diffusion qui suit le mieux les consignes | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | SDXL optimisé pour le photoréalisme | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | Le modèle d'images le plus rapide de Mage | z-image-turbo | 10 Gems ($0.01) |
Modèles vidéo
Modèles de génération de vidéos
| Modèle | Idéal pour | Valeurs de model_id | Prix par défaut |
|---|---|---|---|
| Berry | Une vidéo fidèle à tes références | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | Fixe la première et la dernière image | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | Notre famille vidéo phare | cherry-mini, cherry, cherry-pro, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine, en mouvement | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | La vidéo au quotidien, sans configuration | kiwi | 270 Gems ($0.27) |
| Lemon | Toutes les fonctions vidéo, à prix plus doux | lemon | 245 Gems ($0.245) |
| LTX Video | Vidéo open-weights rapide pour itérer | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Melon | L'animation manga en mouvement, avec audio en option | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | Vidéo ouverte rapide avec son stéréo | minimax-h3-turbo, minimax-h3 | 30 Gems ($0.03) |
| Plum | Du son sur chaque clip, jusqu'en 2K | plum, plum-max | 338 Gems ($0.338) |
| Raspberry | Des personnages animés à partir d'une première image | raspberry | 360 Gems ($0.36) |
| Wan Video v2.2 | Vidéo open-weights avec une variante Lightning | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
Modèles audio
Modèles de génération audio
| Modèle | Idéal pour | Valeurs de model_id | Prix par défaut |
|---|---|---|---|
| Seed Audio | Voix, musique et effets sonores à partir d'un seul prompt | seed-audio-1.0 | 19 Gems ($0.019) |
FAQ
Questions fréquentes
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.