Das Mage Python-SDK

Auf einen Blick

Das Mage Python-SDK ist der offizielle Open-Source-Client für die Mage API und wird als mage-space veröffentlicht. Installiere es mit "pip install mage-space", setze MAGE_API_KEY und rufe mage.run mit einer Modell-ID und einer Config auf, um fertige Bilder, Videos oder Audio von einem der 28 Modelle zu erhalten. Es läuft mit Python 3.10 oder neuer, und jede Generierung wird mit Gems bezahlt.

• 3.10+

  Python

• httpx

  HTTP-Client

• 28

  Typisierte Modelle

• MIT

  Open Source

Einrichtung

Python-SDK installieren und ein Modell ausführen

1. 01

   Paket installieren

   Füge mage-space zu deinem Projekt hinzu.

   pip install mage-space

2. 02

   API-Key festlegen

   Erstelle auf mage.space unter API → API Keys einen Key und exportiere ihn. Der Client liest MAGE_API_KEY.

   export MAGE_API_KEY="mage_sk_..."

3. 03

   Generieren

   Rufe run mit einer Modell-ID und der zugehörigen Konfiguration auf. Es wartet auf das Ergebnis und gibt es zurück; die Ausgabe findest du unter 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"])

Beispiele

Das Python-SDK in der Praxis

Jedes Beispiel beginnt mit einem Client, der MAGE_API_KEY liest.

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)

Warum das SDK

Was das SDK für dich übernimmt

Referenz

Das Python-SDK im Überblick

Dieselben Methoden decken jedes Modell ab; das Modell ist das erste Argument.

Modelle

Starte mit diesen Modellen

FAQ

Häufig gestellte Fragen

Starte jetzt mit Mage

Ein Konto, ein Gems-Guthaben, alle Modelle. Du zahlst nur für das, was du generierst.

Ähnliche Inhalte

• Mage SDKs
• Mage TypeScript-SDK
• Mage für ComfyUI
• mage-space auf PyPI
• Alle API-Modelle
• API-Dokumentation