L'API de génération d'images IA pour tous les modèles

En un coup d’œil

L'API de génération d'images de Mage est une API REST disponible à l'adresse https://api.mage.space/v1, qui fait tourner 15 modèles de texte vers image et de retouche d'images, dont Mango 3, Guava 2 Pro, GPT Image 2.5, 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 se paie en Gems, sans abonnement.

• 15

  modèles d'images

• $0.009

  Tarif par défaut le plus bas, par image

• 20

  Générations simultanées

• $0

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

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.

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"

// 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);

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

1. 01

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

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

   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

Cas d'usage

Ce que les développeurs créent avec l'API d'images

FAQ

Questions fréquentes

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.

À voir aussi

• API de génération de vidéos IA
• API de génération audio IA
• Serveur MCP Mage
• SDK Mage
• Mage pour ComfyUI
• Tous les modèles de l'API
• Playground de l'API
• Documentation de l'API