API Mage · Génération d'images
L'API de génération d'images IA pour tous les modèles
Texte vers image, retouche d'image et personnages cohérents avec 18 modèles, dont Mango 4, le modèle phare de Mage, via une seule clé et un seul solde.
POST https://api.mage.space/v1/{model}/generateEn un coup d’œil
L'API de génération d'images de Mage est une API REST à https://api.mage.space/v1 qui fait tourner 18 modèles de texte vers image et de retouche d'image, dont Mango 4, Guava 2 Pro, GPT Image 2.6, Nano Banana 2, Flux 2 et Krea 2. Tu envoies un prompt en POST à /{model}/generate, tu interroges la requête, puis tu télécharges l'image. Chaque image est payée en Gems, sans abonnement.
- 18modèles d'images
- $0.009Tarif par défaut le plus bas, par image
- 20Générations simultanées
- $0Frais mensuels
Modèles
Tous les modèles d'images de l'API Mage
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, gpt-image-2.6-flare, gpt-image-2.6-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine, en deux versions | grok-imagine-image, grok-imagine-image-2.0 | 90 Gems ($0.09) |
| 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, mango-v4 | 42 Gems ($0.042) |
| MiniMax H3 Image | Images natives de 16 mégapixels, poids ouverts | minimax-h3-image | 15 Gems ($0.015) |
| MOSS-Image | Prompts longs et texte bilingue, poids ouverts | moss-image | 25 Gems ($0.025) |
| Nano Banana 2 | Texte net et lisible, jusqu'en 4K | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | SDXL avec visages et mains corrigés | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Seedream | Seedream, avec un filtre strict | seedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.5 | 42 Gems ($0.042) |
| 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) |
Démarrage rapide
Génère une image avec Anima v1
Définis MAGE_API_KEY, envoie la requête, puis interroge jusqu'à la fin de la génération. Remplace anima dans l'URL par n'importe quel modèle ci-dessus.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/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": "anima-v1"
}' | 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('anima', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'anima-v1',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("anima", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "anima-v1",
})
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.
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.
Cas d'usage
Ce que les développeurs créent avec l'API d'images
Images produit et marketing
Crée à la demande des visuels produit, des variantes de pubs et des posts pour les réseaux sociaux, avec du texte lisible grâce à GPT Image 2.6 ou Nano Banana 2.
Personnages cohérents
Enregistre un personnage une seule fois et garde le même visage dans toute une série avec Mango 4, Guava 2 Pro et d'autres modèles qui acceptent les mentions @handle.
Pipelines d'édition d'images
Envoie une image source avec une instruction pour modifier exactement ce que tu demandes et laisser le reste en place.
Applications et jeux
Génère des avatars, des stickers, des cartes et des scènes directement dans ton produit, sans héberger le moindre GPU.
Portraits photoréalistes
Guava 2 Pro génère des portraits, des photos de mode et de lifestyle avec une peau, des tissus et une lumière criants de réalisme.
Brouillons rapides à grande échelle
Z-Image Turbo et Krea 2 maintiennent des prix bas pour les miniatures en grand volume et les premières versions.
FAQ
Questions fréquentes
Quelle est la meilleure API de génération d'images par IA ?
L'API d'images permet-elle l'édition d'images et les images de référence ?
Quelles résolutions l'API d'images prend-elle en charge ?
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.