Le SDK Python de Mage

En un coup d’œil

Le SDK Python de Mage est le client officiel et open source de l'API Mage, publié sous le nom mage-space. Installe-le avec « pip install mage-space », définis MAGE_API_KEY, puis appelle mage.run avec un identifiant de modèle et une configuration pour obtenir des images, des vidéos ou de l'audio finalisés avec l'un des 28 modèles. Il fonctionne avec Python 3.10 ou version ultérieure, et chaque génération est payée en Gems.

• 3.10+

  Python

• httpx

  Client HTTP

• 28

  Modèles typés

• MIT

  Open source

Configuration

Installe le SDK Python et lance un modèle

1. 01

   Installer le paquet

   Ajoute mage-space à ton projet.

   pip install mage-space

2. 02

   Définir ta clé d’API

   Crée une clé dans API → API Keys sur mage.space et exporte-la. Le client lit MAGE_API_KEY.

   export MAGE_API_KEY="mage_sk_..."

3. 03

   Générer

   Appelle run avec un identifiant de modèle et sa configuration. Il attend le résultat et le renvoie ; le fichier généré se trouve dans result.url.

   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-v3",
   })
   
   print(request["result"]["url"])

Exemples

Le SDK Python en pratique

Chaque exemple part d’un client qui lit MAGE_API_KEY.

from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

submitted = mage.generate("cherry", {
    "prompt": "Waves rolling onto a black sand beach at sunset",
    "resolution": "720p",
    "duration": "5",
})

final = mage.requests.wait(
    submitted["request_id"],
    timeout=900,
    on_update=lambda request: print(request["status"]),
)

from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

clip = mage.uploads.upload("clip.mp4")  # a path, bytes, or a binary file

mage.run("cherry", {
    "prompt": "Restyle this clip as a watercolor painting",
    "videos": [clip["url"]],
})

from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

mage.characters.create(
    name="Ana",
    handle="ana",
    image="https://example.com/ana.png",
)

mage.run("mango", {"prompt": "@ana walking through a night market"})

from mage_space import Mage, MageAPIError, MageGenerationError

mage = Mage()  # reads MAGE_API_KEY

try:
    mage.run("mango", {"prompt": "A lighthouse at night"})
except MageAPIError as error:
    if error.code == "insufficient_gems":
        print("Gems needed:", error.body["error"]["gems_required"])
    else:
        raise
except MageGenerationError as error:
    print("No output:", error.code)

Pourquoi le SDK

Ce que le SDK gère pour toi

Référence

Le SDK Python en un coup d'œil

Les mêmes méthodes couvrent tous les modèles ; le modèle est le premier argument.

Modèles

Commence avec ces modèles

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

• SDK Mage
• SDK TypeScript de Mage
• Mage pour ComfyUI
• mage-space sur PyPI
• Tous les modèles de l'API
• Documentation de l'API