De Mage Python SDK

In één oogopslag

De Mage Python SDK is de officiële open-sourceclient voor de Mage API, gepubliceerd als mage-space. Installeer hem met "pip install mage-space", stel MAGE_API_KEY in en roep mage.run aan met een model-id en een config om kant-en-klare afbeeldingen, video of audio te krijgen van een van de 28 modellen. Hij draait op Python 3.10 of nieuwer en elke generatie betaal je met Gems.

• 3.10+

  Python

• httpx

  HTTP-client

• 28

  Getypeerde modellen

• MIT

  Open source

Instellen

Installeer de Python SDK en draai een model

1. 01

   Installeer het pakket

   Voeg mage-space toe aan je project.

   pip install mage-space

2. 02

   Stel je API-sleutel in

   Maak een sleutel aan via API → API Keys op mage.space en exporteer die. De client leest MAGE_API_KEY.

   export MAGE_API_KEY="mage_sk_..."

3. 03

   Genereer

   Roep run aan met een model-id en de bijbehorende config. De functie wacht op het resultaat en geeft het terug; de output staat in 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"])

Voorbeelden

De Python SDK in de praktijk

Elk voorbeeld begint met een client die MAGE_API_KEY leest.

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)

Waarom de SDK

Wat de SDK voor je regelt

Referentie

De Python SDK in één oogopslag

Dezelfde methoden gelden voor elk model; het model is het eerste argument.

Modellen

Begin met deze modellen

FAQ

Veelgestelde vragen

Begin met bouwen met Mage

Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.

Gerelateerd

• Mage SDK's
• Mage TypeScript SDK
• Mage voor ComfyUI
• mage-space op PyPI
• Alle API-modellen
• API-documentatie